safari-pilot 0.1.0

package/dist/server.js

@@ -0,0 +1,347 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { selectEngine } from './engine-selector.js';
+import { AppleScriptEngine } from './engines/applescript.js';
+import { DaemonEngine } from './engines/daemon.js';
+import { NavigationTools } from './tools/navigation.js';
+import { InteractionTools } from './tools/interaction.js';
+import { ExtractionTools } from './tools/extraction.js';
+import { NetworkTools } from './tools/network.js';
+import { StorageTools } from './tools/storage.js';
+import { ShadowTools } from './tools/shadow.js';
+import { FrameTools } from './tools/frames.js';
+import { PermissionTools } from './tools/permissions.js';
+import { ClipboardTools } from './tools/clipboard.js';
+import { ServiceWorkerTools } from './tools/service-workers.js';
+import { PerformanceTools } from './tools/performance.js';
+import { StructuredExtractionTools } from './tools/structured-extraction.js';
+import { WaitTools } from './tools/wait.js';
+import { CompoundTools } from './tools/compound.js';
+import { KillSwitch } from './security/kill-switch.js';
+import { TabOwnership } from './security/tab-ownership.js';
+import { AuditLog } from './security/audit-log.js';
+import { DomainPolicy } from './security/domain-policy.js';
+import { RateLimiter } from './security/rate-limiter.js';
+import { CircuitBreaker } from './security/circuit-breaker.js';
+import { IdpiScanner } from './security/idpi-scanner.js';
+import { RateLimitedError, CircuitBreakerOpenError } from './errors.js';
+const execFileAsync = promisify(execFile);
+// Per-check timeout: short enough to keep the total health check fast,
+// long enough to survive a sluggish osascript startup (~100-300 ms typical).
+const HEALTH_CHECK_TIMEOUT_MS = 3000;
+async function checkSafariRunning() {
+    try {
+        await execFileAsync('osascript', ['-e', 'tell application "Safari" to return name'], {
+            timeout: HEALTH_CHECK_TIMEOUT_MS,
+        });
+        return { name: 'safari_running', ok: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { name: 'safari_running', ok: false, detail: message };
+    }
+}
+async function checkJsFromAppleEvents() {
+    try {
+        const result = await execFileAsync('osascript', ['-e', 'tell application "Safari" to do JavaScript "1+1" in current tab of front window'], { timeout: HEALTH_CHECK_TIMEOUT_MS });
+        const value = result.stdout.trim();
+        return { name: 'js_apple_events', ok: value === '2', detail: value !== '2' ? `Unexpected: ${value}` : undefined };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'js_apple_events',
+            ok: false,
+            detail: message.includes('-1743') || message.includes('permission') || message.includes('Apple Events')
+                ? 'JS from Apple Events is disabled. Enable in Safari > Develop > Allow JavaScript from Apple Events'
+                : message,
+        };
+    }
+}
+async function checkScreenRecording() {
+    try {
+        // screencapture -x captures without sound; a permission error means SR is blocked
+        await execFileAsync('screencapture', ['-x', '-t', 'png', '/dev/null'], { timeout: HEALTH_CHECK_TIMEOUT_MS });
+        return { name: 'screen_recording', ok: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'screen_recording',
+            ok: false,
+            detail: 'Screen Recording permission not granted. Enable in System Settings > Privacy & Security > Screen Recording',
+        };
+    }
+}
+// ── Tool names that skip ownership enforcement ──────────────────────────────
+const SKIP_OWNERSHIP_TOOLS = new Set([
+    'safari_list_tabs',
+    'safari_new_tab',
+    'safari_health_check',
+]);
+export class SafariPilotServer {
+    tools = new Map();
+    engines = new Map();
+    engineAvailability = { daemon: false, extension: false };
+    sessionId = `sess_${Date.now().toString(36)}`;
+    _engine = null;
+    // ── Security layers ─────────────────────────────────────────────────────────
+    killSwitch;
+    tabOwnership;
+    auditLog;
+    domainPolicy;
+    rateLimiter;
+    circuitBreaker;
+    idpiScanner;
+    constructor() {
+        this.auditLog = new AuditLog();
+        this.killSwitch = new KillSwitch({ auditLog: this.auditLog });
+        this.tabOwnership = new TabOwnership();
+        this.domainPolicy = new DomainPolicy();
+        this.rateLimiter = new RateLimiter();
+        this.circuitBreaker = new CircuitBreaker();
+        this.idpiScanner = new IdpiScanner();
+    }
+    async initialize() {
+        // Instantiate and probe the DaemonEngine first (fastest path)
+        const daemonEngine = new DaemonEngine();
+        const daemonAvailable = await daemonEngine.isAvailable();
+        this.setEngineAvailability({ daemon: daemonAvailable, extension: false });
+        if (daemonAvailable) {
+            this.engines.set('daemon', daemonEngine);
+        }
+        else {
+            // Ensure daemon is cleaned up if it failed to start
+            await daemonEngine.shutdown();
+        }
+        // Instantiate the AppleScript engine (always available as fallback)
+        const engine = new AppleScriptEngine();
+        this._engine = engine;
+        // Register health check tool (real implementation)
+        this.registerTool({
+            name: 'safari_health_check',
+            description: 'Verify all required macOS permissions and system prerequisites are met.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    verbose: {
+                        type: 'boolean',
+                        description: 'Include detailed system info',
+                        default: false,
+                    },
+                },
+            },
+            requirements: {},
+            handler: async (params) => this.handleHealthCheck(params),
+        });
+        // Instantiate all tool modules
+        const navTools = new NavigationTools(engine);
+        const interactionTools = new InteractionTools(engine);
+        const extractionTools = new ExtractionTools(engine);
+        const networkTools = new NetworkTools(engine);
+        const storageTools = new StorageTools(engine);
+        const shadowTools = new ShadowTools(engine);
+        const frameTools = new FrameTools(engine);
+        const permissionTools = new PermissionTools(engine);
+        const clipboardTools = new ClipboardTools(engine);
+        const serviceWorkerTools = new ServiceWorkerTools(engine);
+        const performanceTools = new PerformanceTools(engine);
+        const structuredExtractionTools = new StructuredExtractionTools(engine);
+        const waitTools = new WaitTools(engine);
+        const compoundTools = new CompoundTools(engine);
+        const modules = [
+            navTools,
+            interactionTools,
+            extractionTools,
+            networkTools,
+            storageTools,
+            shadowTools,
+            frameTools,
+            permissionTools,
+            clipboardTools,
+            serviceWorkerTools,
+            performanceTools,
+            structuredExtractionTools,
+            waitTools,
+            compoundTools,
+        ];
+        for (const module of modules) {
+            for (const def of module.getDefinitions()) {
+                const handler = module.getHandler(def.name);
+                if (!handler) {
+                    throw new Error(`No handler found for tool "${def.name}"`);
+                }
+                this.registerTool({
+                    ...def,
+                    handler,
+                });
+            }
+        }
+        // Emergency stop — system tool, registered directly (not via a module)
+        this.registerTool({
+            name: 'safari_emergency_stop',
+            description: 'Emergency stop — immediately close all agent-owned tabs, activate kill switch, and block all further automation.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    reason: { type: 'string', description: 'Reason for the emergency stop' },
+                },
+            },
+            requirements: {},
+            handler: async (params) => {
+                const reason = params['reason'] ?? 'emergency_stop called';
+                this.killSwitch.activate(reason);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ stopped: true, reason }) }],
+                    metadata: { engine: 'applescript', degraded: false, latencyMs: 0 },
+                };
+            },
+        });
+    }
+    async handleHealthCheck(params) {
+        const start = Date.now();
+        const checks = [];
+        // 1. Safari running?
+        const safariCheck = await checkSafariRunning();
+        checks.push(safariCheck);
+        // 2. JS from Apple Events enabled?
+        const jsCheck = await checkJsFromAppleEvents();
+        checks.push(jsCheck);
+        // 3. Screen Recording permission?
+        const srCheck = await checkScreenRecording();
+        checks.push(srCheck);
+        // 4. Daemon available?
+        checks.push({ name: 'daemon', ok: this.engineAvailability.daemon });
+        // 5. Extension connected?
+        checks.push({ name: 'extension', ok: this.engineAvailability.extension });
+        const healthy = checks.every((c) => c.name === 'daemon' || c.name === 'extension' || c.ok);
+        const failedChecks = checks.filter((c) => !c.ok).map((c) => c.name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        healthy,
+                        checks,
+                        failedChecks,
+                        sessionId: this.sessionId,
+                    }),
+                },
+            ],
+            metadata: {
+                engine: 'applescript',
+                degraded: !healthy,
+                latencyMs: Date.now() - start,
+            },
+        };
+    }
+    registerTool(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    async callTool(name, params) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            throw new Error(`Unknown tool: ${name}`);
+        return tool.handler(params);
+    }
+    /**
+     * Execute a tool through the full security pipeline:
+     * kill switch → tab ownership → domain policy → rate limiter →
+     * circuit breaker → tool execution → audit log
+     */
+    async executeToolWithSecurity(name, params) {
+        const start = Date.now();
+        // 1. Kill switch check — blocks all automation when active
+        this.killSwitch.checkBeforeAction();
+        // 2. Extract URL / domain from params
+        const url = (params['tabUrl'] ?? params['url'] ?? '');
+        let domain;
+        try {
+            domain = new URL(url || 'about:blank').hostname;
+        }
+        catch {
+            domain = '';
+        }
+        // 3. Tab ownership check — skip for tools that operate without a specific tab
+        if (params['tabUrl'] && !SKIP_OWNERSHIP_TOOLS.has(name)) {
+            const tabUrl = params['tabUrl'];
+            const tabId = this.tabOwnership.findByUrl(tabUrl);
+            if (tabId !== undefined) {
+                this.tabOwnership.assertOwnership(tabId);
+            }
+            // If tabId is undefined the tool handler will surface its own error;
+            // ownership enforcement only applies to tabs we know about.
+        }
+        // 4. Domain policy evaluation
+        const policy = this.domainPolicy.evaluate(url);
+        // 5. Rate limit check — check before recording so we don't consume quota on blocked calls
+        const limitCheck = this.rateLimiter.checkLimit(domain);
+        if (!limitCheck.allowed) {
+            throw new RateLimitedError(domain, policy.maxActionsPerMinute);
+        }
+        this.rateLimiter.recordAction(domain);
+        // 6. Circuit breaker check
+        if (this.circuitBreaker.isOpen(domain)) {
+            throw new CircuitBreakerOpenError(domain, 120);
+        }
+        // 7. Execute the tool, record circuit breaker outcome, and audit
+        try {
+            const result = await this.callTool(name, params);
+            this.circuitBreaker.recordSuccess(domain);
+            // 8. Audit log — success path
+            this.auditLog.record({
+                tool: name,
+                tabUrl: url,
+                engine: 'applescript',
+                params,
+                result: 'ok',
+                elapsed_ms: Date.now() - start,
+                session: this.sessionId,
+            });
+            return result;
+        }
+        catch (error) {
+            this.circuitBreaker.recordFailure(domain);
+            // 8. Audit log — error path
+            this.auditLog.record({
+                tool: name,
+                tabUrl: url,
+                engine: 'applescript',
+                params,
+                result: 'error',
+                elapsed_ms: Date.now() - start,
+                session: this.sessionId,
+            });
+            throw error;
+        }
+    }
+    getSelectedEngine(requirements) {
+        return selectEngine(requirements, this.engineAvailability);
+    }
+    setEngineAvailability(availability) {
+        this.engineAvailability = availability;
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    getEngine() {
+        return this._engine;
+    }
+    async start() {
+        await this.initialize();
+        console.error('Safari Pilot MCP server started');
+    }
+    async shutdown() {
+        for (const engine of this.engines.values()) {
+            await engine.shutdown();
+        }
+    }
+}
+export async function createServer() {
+    const server = new SafariPilotServer();
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/clipboard.d.ts

@@ -0,0 +1,15 @@
+import type { ToolResponse } from '../types.js';
+import type { AppleScriptEngine } from '../engines/applescript.js';
+import type { ToolDefinition } from './navigation.js';
+type Handler = (params: Record<string, unknown>) => Promise<ToolResponse>;
+export declare class ClipboardTools {
+    private readonly engine;
+    constructor(engine: AppleScriptEngine);
+    getDefinitions(): ToolDefinition[];
+    getHandler(name: string): Handler;
+    private handleClipboardRead;
+    private handleClipboardWrite;
+    private parseJson;
+    private errorResponse;
+}
+export {};

package/dist/tools/clipboard.js

@@ -0,0 +1,128 @@
+/**
+ * JS that reads clipboard text.
+ * navigator.clipboard.readText() requires a user gesture in Safari; if it
+ * rejects, we surface a capability flag so callers can branch accordingly.
+ */
+const CLIPBOARD_READ_JS = `
+(async () => {
+  try {
+    const text = await navigator.clipboard.readText();
+    return JSON.stringify({ text, clipboardAvailable: true });
+  } catch (err) {
+    return JSON.stringify({ text: null, clipboardAvailable: false, error: String(err) });
+  }
+})()
+`.trim();
+/** JS that writes text to the clipboard. */
+function buildClipboardWriteJs(text) {
+    const escaped = JSON.stringify(text);
+    return `
+(async () => {
+  try {
+    await navigator.clipboard.writeText(${escaped});
+    return JSON.stringify({ written: true, text: ${escaped} });
+  } catch (err) {
+    return JSON.stringify({ written: false, error: String(err) });
+  }
+})()
+`.trim();
+}
+export class ClipboardTools {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    getDefinitions() {
+        return [
+            {
+                name: 'safari_clipboard_read',
+                description: 'Read the current clipboard text content from the page context. ' +
+                    'Returns the clipboard text and a clipboardAvailable flag. ' +
+                    'Note: navigator.clipboard.readText() requires a prior user gesture in Safari — ' +
+                    'if unavailable, clipboardAvailable will be false.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab to read clipboard from' },
+                    },
+                    required: ['tabUrl'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_clipboard_write',
+                description: 'Write text to the clipboard from the page context via navigator.clipboard.writeText().',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab to execute clipboard write in' },
+                        text: { type: 'string', description: 'Text to write to the clipboard' },
+                    },
+                    required: ['tabUrl', 'text'],
+                },
+                requirements: {},
+            },
+        ];
+    }
+    getHandler(name) {
+        switch (name) {
+            case 'safari_clipboard_read':
+                return (p) => this.handleClipboardRead(p);
+            case 'safari_clipboard_write':
+                return (p) => this.handleClipboardWrite(p);
+            default:
+                throw new Error(`ClipboardTools: unknown tool "${name}"`);
+        }
+    }
+    // ── Handlers ────────────────────────────────────────────────────────────────
+    async handleClipboardRead(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const script = this.engine.buildTabScript(tabUrl, CLIPBOARD_READ_JS);
+        const result = await this.engine.execute(script);
+        if (!result.ok) {
+            return this.errorResponse(result.error?.message ?? 'Clipboard read failed', start);
+        }
+        const data = this.parseJson(result.value) ?? { text: null, clipboardAvailable: false };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data) }],
+            metadata: { engine: 'applescript', degraded: false, latencyMs: Date.now() - start },
+        };
+    }
+    async handleClipboardWrite(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const text = params['text'];
+        const js = buildClipboardWriteJs(text);
+        const script = this.engine.buildTabScript(tabUrl, js);
+        const result = await this.engine.execute(script);
+        if (!result.ok) {
+            return this.errorResponse(result.error?.message ?? 'Clipboard write failed', start);
+        }
+        const data = this.parseJson(result.value) ?? { written: false };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data) }],
+            metadata: { engine: 'applescript', degraded: false, latencyMs: Date.now() - start },
+        };
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    parseJson(value) {
+        if (!value)
+            return undefined;
+        try {
+            const parsed = JSON.parse(value);
+            return typeof parsed === 'object' && parsed !== null ? parsed : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    errorResponse(message, start) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+            metadata: { engine: 'applescript', degraded: true, latencyMs: Date.now() - start },
+        };
+    }
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/tools/clipboard.js.map

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

package/dist/tools/compound.d.ts

@@ -0,0 +1,68 @@
+import type { ToolResponse, ToolRequirements } from '../types.js';
+import type { AppleScriptEngine } from '../engines/applescript.js';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    requirements: ToolRequirements;
+}
+type Handler = (params: Record<string, unknown>) => Promise<ToolResponse>;
+export interface FlowStep {
+    action: 'navigate' | 'click' | 'fill' | 'wait' | 'assert';
+    selector?: string;
+    value?: string;
+    assert?: {
+        type: 'text' | 'element' | 'url';
+        expected: string;
+    };
+}
+export interface FlowStepResult {
+    step: number;
+    result: string;
+    passed: boolean;
+}
+export interface TestFlowResult {
+    passed: boolean;
+    steps: FlowStepResult[];
+    failedAt?: number;
+    screenshot?: string;
+}
+export interface PageChange {
+    check: number;
+    timestamp: string;
+    diff: string;
+}
+export interface MonitorResult {
+    changes: PageChange[];
+    checksPerformed: number;
+    finalSnapshot?: string;
+}
+export interface ScrapedPage {
+    pageNum: number;
+    url: string;
+    data: unknown;
+}
+export interface PaginateResult {
+    pages: ScrapedPage[];
+    totalPages: number;
+}
+export interface MediaState {
+    action: string;
+    currentTime: number;
+    duration: number;
+    paused: boolean;
+    muted: boolean;
+    volume: number;
+    playbackRate: number;
+}
+export declare class CompoundTools {
+    private readonly engine;
+    constructor(engine: AppleScriptEngine);
+    getDefinitions(): ToolDefinition[];
+    getHandler(name: string): Handler;
+    private handleTestFlow;
+    private handleMonitorPage;
+    private handlePaginateScrape;
+    private handleMediaControl;
+}
+export {};