aether-mcp-server 2.1.0 → 2.1.1

package/dist/types.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RememberAetherLessonSchema = exports.ConfigureAetherMemorySchema = exports.LoadAuthStateSchema = exports.SaveAuthStateSchema = exports.GetPageTextSchema = exports.PageSnapshotSchema = exports.AgentFormFillSchema = exports.ObserveAndActSchema = exports.SmartNavigateSchema = exports.AgentActionSchema = exports.SolveCaptchaSchema = exports.DetectCaptchaSchema = exports.CdpCommandSchema = exports.ExecuteScriptSchema = exports.GetNetworkErrorsSchema = exports.GetLogsSchema = exports.ActSchema = exports.BrowserIntentSchema = exports.ElementAtPointSchema = exports.PressKeySchema = exports.FillLabelSchema = exports.ClickRoleSchema = exports.ClickTextSchema = exports.WaitForTextSchema = exports.WaitForSelectorSchema = exports.FillBySelectorSchema = exports.ClickBySelectorSchema = exports.ClickByRefSchema = exports.BrowserStatusSchema = exports.ListInteractiveElementsSchema = exports.SnapshotCompactSchema = exports.GetStateSchema = exports.ConnectBrowserSchema = void 0;
+/**
+ * Aether MCP Server — Shared Types
+ *
+ * All Zod-inferred types for end-to-end type safety across the bridge,
+ * client, and MCP tool handlers. Generated from the schemas in mcp-server.ts.
+ */
+const zod_1 = require("zod");
+// ─── Browser Connection ───────────────────────────────────────────────
+exports.ConnectBrowserSchema = zod_1.z.object({
+    mode: zod_1.z.enum(["connect", "launch", "auto", "ask"]).optional(),
+    port: zod_1.z.number().optional(),
+    headless: zod_1.z.boolean().optional(),
+    browser: zod_1.z.enum(["chrome", "edge", "brave", "firefox"]).optional(),
+    profile: zod_1.z.string().optional(),
+    profileDirectory: zod_1.z.string().optional(),
+    userDataDir: zod_1.z.string().optional(),
+});
+// ─── State & Snapshot ─────────────────────────────────────────────────
+exports.GetStateSchema = zod_1.z.object({
+    screenshot: zod_1.z.boolean().optional(),
+    domSnapshot: zod_1.z.boolean().optional(),
+    elements: zod_1.z.boolean().optional(),
+    som: zod_1.z.boolean().optional(),
+    tabs: zod_1.z.boolean().optional(),
+});
+exports.SnapshotCompactSchema = zod_1.z.object({
+    maxElements: zod_1.z.number().optional(),
+    includeText: zod_1.z.boolean().optional(),
+});
+exports.ListInteractiveElementsSchema = zod_1.z.object({
+    maxElements: zod_1.z.number().optional(),
+    withOverlay: zod_1.z.boolean().optional(),
+});
+exports.BrowserStatusSchema = zod_1.z.object({
+    includeTargets: zod_1.z.boolean().optional(),
+});
+// ─── Interaction ──────────────────────────────────────────────────────
+exports.ClickByRefSchema = zod_1.z.object({
+    ref: zod_1.z.string(),
+});
+exports.ClickBySelectorSchema = zod_1.z.object({
+    selector: zod_1.z.string(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.FillBySelectorSchema = zod_1.z.object({
+    selector: zod_1.z.string(),
+    value: zod_1.z.string(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.WaitForSelectorSchema = zod_1.z.object({
+    selector: zod_1.z.string(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.WaitForTextSchema = zod_1.z.object({
+    text: zod_1.z.string(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.ClickTextSchema = zod_1.z.object({
+    text: zod_1.z.string(),
+    role: zod_1.z.string().optional(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.ClickRoleSchema = zod_1.z.object({
+    role: zod_1.z.string(),
+    name: zod_1.z.string().optional(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.FillLabelSchema = zod_1.z.object({
+    label: zod_1.z.string(),
+    value: zod_1.z.string(),
+    role: zod_1.z.string().optional(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.PressKeySchema = zod_1.z.object({
+    key: zod_1.z.string(),
+    modifiers: zod_1.z.array(zod_1.z.string()).optional(),
+});
+exports.ElementAtPointSchema = zod_1.z.object({
+    x: zod_1.z.number().optional(),
+    y: zod_1.z.number().optional(),
+    coordinate: zod_1.z.string().optional(),
+});
+// ─── Browser Intent ───────────────────────────────────────────────────
+exports.BrowserIntentSchema = zod_1.z.object({
+    intent: zod_1.z.enum(["click", "fill", "select", "check", "wait_for", "inspect", "navigate"]),
+    target: zod_1.z.string().optional(),
+    value: zod_1.z.string().optional(),
+    role: zod_1.z.string().optional(),
+    timeout: zod_1.z.number().optional(),
+    verify: zod_1.z.string().optional(),
+    includeCandidates: zod_1.z.boolean().optional(),
+});
+// ─── Act (Primary Action Tool) ────────────────────────────────────────
+exports.ActSchema = zod_1.z.object({
+    action: zod_1.z.enum([
+        "navigate", "click", "type", "fill", "select", "check",
+        "hover", "scroll", "wait", "screenshot",
+        "new_tab", "switch_tab", "close_tab", "drag_and_drop", "upload_file",
+        "get_tree", "get_dom_tree", "configure", "print_pdf", "emulate_network",
+        "get_cookies", "set_cookie", "clear_cache", "set_geolocation", "set_timezone",
+        "get_performance_metrics",
+        "start_screencast", "stop_screencast", "record_session", "sample_visual_frames",
+        "mock_network_request", "highlight_elements",
+        "assert", "start_tracing", "stop_tracing",
+        "screenshot_region", "verify_ui_state", "get_dom_snapshot", "get_event_listeners",
+        "get_computed_style", "get_network_traffic", "get_network_response",
+        "get_screencast_frames", "get_dom_storage", "get_logs", "press_key", "key_combo",
+        "click_text", "click_role", "fill_label", "element_at_point", "detect_captcha",
+    ]),
+    selector: zod_1.z.string().optional(),
+    text: zod_1.z.string().optional(),
+    key: zod_1.z.string().optional(),
+    role: zod_1.z.string().optional(),
+    name: zod_1.z.string().optional(),
+    label: zod_1.z.string().optional(),
+    elementId: zod_1.z.string().optional(),
+    value: zod_1.z.string().optional(),
+    assertionType: zod_1.z.string().optional(),
+    options: zod_1.z.record(zod_1.z.any()).optional(),
+    domain: zod_1.z.string().optional(),
+    coordinate: zod_1.z.string().optional(),
+    x: zod_1.z.number().optional(),
+    y: zod_1.z.number().optional(),
+    visible: zod_1.z.boolean().optional(),
+    stable: zod_1.z.boolean().optional(),
+    parentId: zod_1.z.string().optional(),
+    projectRoot: zod_1.z.string().optional(),
+    tabId: zod_1.z.number().optional(),
+    files: zod_1.z.array(zod_1.z.string()).optional(),
+    modifiers: zod_1.z.array(zod_1.z.string()).optional(),
+    format: zod_1.z.string().optional(),
+    quality: zod_1.z.number().optional(),
+    maxWidth: zod_1.z.number().optional(),
+    maxHeight: zod_1.z.number().optional(),
+    everyNthFrame: zod_1.z.number().optional(),
+    maxFrames: zod_1.z.number().optional(),
+    duration: zod_1.z.number().optional(),
+    cookieName: zod_1.z.string().optional(),
+    cookieValue: zod_1.z.string().optional(),
+    latitude: zod_1.z.number().optional(),
+    longitude: zod_1.z.number().optional(),
+    timezoneId: zod_1.z.string().optional(),
+    urlPattern: zod_1.z.string().optional(),
+    mockResponse: zod_1.z.string().optional(),
+    markdownSummary: zod_1.z.string().optional(),
+    requestId: zod_1.z.string().optional(),
+    offline: zod_1.z.boolean().optional(),
+    latency: zod_1.z.number().optional(),
+    downloadThroughput: zod_1.z.number().optional(),
+    uploadThroughput: zod_1.z.number().optional(),
+    landscape: zod_1.z.boolean().optional(),
+    printBackground: zod_1.z.boolean().optional(),
+    network: zod_1.z.object({
+        blockImages: zod_1.z.boolean().optional(),
+        blockAds: zod_1.z.boolean().optional(),
+        blockCSS: zod_1.z.boolean().optional(),
+    }).optional(),
+    emulation: zod_1.z.object({
+        width: zod_1.z.number().optional(),
+        height: zod_1.z.number().optional(),
+        mobile: zod_1.z.boolean().optional(),
+        userAgent: zod_1.z.string().optional(),
+    }).optional(),
+    script: zod_1.z.object({
+        onLoad: zod_1.z.string().optional(),
+    }).optional(),
+});
+// ─── Debugging ────────────────────────────────────────────────────────
+exports.GetLogsSchema = zod_1.z.object({
+    limit: zod_1.z.number().optional(),
+});
+exports.GetNetworkErrorsSchema = zod_1.z.object({
+    limit: zod_1.z.number().optional(),
+});
+exports.ExecuteScriptSchema = zod_1.z.object({
+    script: zod_1.z.string(),
+});
+exports.CdpCommandSchema = zod_1.z.object({
+    command: zod_1.z.string(),
+    args: zod_1.z.record(zod_1.z.any()).optional(),
+});
+// ─── CAPTCHA ──────────────────────────────────────────────────────────
+exports.DetectCaptchaSchema = zod_1.z.object({});
+exports.SolveCaptchaSchema = zod_1.z.object({
+    useService: zod_1.z.boolean().optional(),
+    service: zod_1.z.enum(["2captcha", "capsolver"]).optional(),
+    apiKey: zod_1.z.string().optional(),
+    pageUrl: zod_1.z.string().optional(),
+    waitAfterClick: zod_1.z.number().optional(),
+    timeout: zod_1.z.number().optional(),
+    pollInterval: zod_1.z.number().optional(),
+});
+// ─── Agent-Centric APIs ───────────────────────────────────────────────
+exports.AgentActionSchema = zod_1.z.object({
+    action: zod_1.z.string(),
+    target: zod_1.z.record(zod_1.z.any()).optional(),
+    verify: zod_1.z.record(zod_1.z.any()).optional(),
+    waitFor: zod_1.z.record(zod_1.z.any()).optional(),
+    timeout: zod_1.z.number().optional(),
+    screenshot: zod_1.z.boolean().optional(),
+});
+exports.SmartNavigateSchema = zod_1.z.object({
+    url: zod_1.z.string(),
+    waitFor: zod_1.z.record(zod_1.z.any()).optional(),
+    dismissPopups: zod_1.z.boolean().optional(),
+    screenshot: zod_1.z.boolean().optional(),
+    timeout: zod_1.z.number().optional(),
+});
+exports.ObserveAndActSchema = zod_1.z.object({
+    action: zod_1.z.record(zod_1.z.any()),
+    observe: zod_1.z.record(zod_1.z.any()).optional(),
+    returnScreenshot: zod_1.z.boolean().optional(),
+});
+exports.AgentFormFillSchema = zod_1.z.object({
+    fields: zod_1.z.array(zod_1.z.record(zod_1.z.any())),
+    submitAfterFill: zod_1.z.boolean().optional(),
+    submitSelector: zod_1.z.string().optional(),
+});
+exports.PageSnapshotSchema = zod_1.z.object({
+    fullPage: zod_1.z.boolean().optional(),
+    includeDOMSnapshot: zod_1.z.boolean().optional(),
+    screenshot: zod_1.z.boolean().optional(),
+    cookies: zod_1.z.boolean().optional(),
+    accessibilityTree: zod_1.z.boolean().optional(),
+});
+// ─── Page Text ────────────────────────────────────────────────────────
+exports.GetPageTextSchema = zod_1.z.object({
+    format: zod_1.z.enum(["markdown", "text"]).optional(),
+    selector: zod_1.z.string().optional(),
+    includeLinks: zod_1.z.boolean().optional(),
+    maxLength: zod_1.z.number().optional(),
+});
+// ─── Auth State ───────────────────────────────────────────────────────
+exports.SaveAuthStateSchema = zod_1.z.object({
+    path: zod_1.z.string().optional(),
+    origins: zod_1.z.array(zod_1.z.any()).optional(),
+});
+exports.LoadAuthStateSchema = zod_1.z.object({
+    path: zod_1.z.string().optional(),
+    reload: zod_1.z.boolean().optional(),
+});
+// ─── Aether Memory ────────────────────────────────────────────────────
+exports.ConfigureAetherMemorySchema = zod_1.z.object({
+    projectRoot: zod_1.z.string().optional(),
+});
+exports.RememberAetherLessonSchema = zod_1.z.object({
+    projectRoot: zod_1.z.string().optional(),
+    title: zod_1.z.string(),
+    trigger: zod_1.z.string(),
+    problemPattern: zod_1.z.string(),
+    symptoms: zod_1.z.array(zod_1.z.string()).optional(),
+    failedApproach: zod_1.z.string().optional(),
+    betterApproach: zod_1.z.string(),
+    createdBecause: zod_1.z.enum([
+        "complex_task_succeeded",
+        "errors_overcome",
+        "user_corrected_approach_worked",
+        "non_trivial_workflow_discovered",
+        "user_asked_to_remember",
+    ]),
+    evidence: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    confidence: zod_1.z.number().optional(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aether-mcp-server",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "Aether MCP Server - AI Browser Controller",
     "main": "dist/index.js",
     "bin": {