@ai-support-agent/cli 0.0.22 → 0.0.23-beta.0

package/dist/mcp/tools/browser/browser-proxy-session.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * BrowserProxySession — proxy that delegates browser operations to the main
+ * process via the local HTTP server.
+ *
+ * Used by MCP tools in the child process when AI_SUPPORT_BROWSER_LOCAL_PORT
+ * is set. Presents the same interface as BrowserSession so that MCP tools
+ * can operate transparently.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserProxySession = void 0;
+const http_1 = __importDefault(require("http"));
+const logger_1 = require("../../../logger");
+const browser_action_log_1 = require("./browser-action-log");
+class BrowserProxySession {
+    baseUrl;
+    sessionId;
+    variables;
+    actionLog = new browser_action_log_1.BrowserActionLog();
+    constructor(baseUrl, sessionId) {
+        this.baseUrl = baseUrl;
+        this.sessionId = sessionId;
+        this.variables = new ProxyVariableMap(baseUrl, sessionId);
+    }
+    /**
+     * Navigate to a URL and return a screenshot buffer.
+     */
+    async navigate(url, options) {
+        const result = await this.post('navigate', {
+            url,
+            waitForSelector: options?.waitForSelector,
+            waitForTimeout: options?.waitForTimeout,
+            fullPage: options?.fullPage ?? true,
+        });
+        return {
+            title: result.title,
+            url: result.url,
+            screenshot: Buffer.from(result.screenshot, 'base64'),
+        };
+    }
+    /**
+     * Click an element by CSS selector.
+     */
+    async click(selector, options) {
+        const result = await this.post('click', {
+            selector,
+            waitForNavigation: options?.waitForNavigation ?? false,
+            screenshot: options?.screenshot ?? true,
+        });
+        return {
+            title: result.title,
+            url: result.url,
+            screenshot: result.screenshot ? Buffer.from(result.screenshot, 'base64') : undefined,
+        };
+    }
+    /**
+     * Fill a form field.
+     */
+    async fill(selector, value, screenshot) {
+        const result = await this.post('fill', { selector, value, screenshot: screenshot ?? false });
+        return result.screenshot ? Buffer.from(result.screenshot, 'base64') : undefined;
+    }
+    /**
+     * Get text content from the page.
+     */
+    async getText(selector) {
+        const result = await this.post('get-text', { selector });
+        return result.text;
+    }
+    /**
+     * Take a screenshot.
+     */
+    async screenshot(fullPage) {
+        const result = await this.post('screenshot', { fullPage: fullPage ?? true });
+        return Buffer.from(result.screenshot, 'base64');
+    }
+    /**
+     * Get the current URL.
+     */
+    async getUrl() {
+        const result = await this.get('url');
+        return result.url;
+    }
+    /**
+     * Get the current page title.
+     */
+    async getTitle() {
+        const result = await this.get('title');
+        return result.title;
+    }
+    /**
+     * Set a session variable.
+     */
+    async setVariable(name, value) {
+        await this.post('variable', { name, value });
+    }
+    /**
+     * Get a session variable.
+     */
+    async getVariable(name) {
+        try {
+            const result = await this.get(`variable/${name}`);
+            return result.value;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * List all session variables.
+     */
+    async listVariables() {
+        const result = await this.get('variables');
+        return (result.variables ?? {});
+    }
+    /**
+     * Stub for isActive — proxy sessions are always considered active
+     * as long as the main process session is alive.
+     */
+    isActive() {
+        return true;
+    }
+    post(action, data) {
+        return httpRequest(this.baseUrl, 'POST', `/browser/${this.sessionId}/${action}`, JSON.stringify(data));
+    }
+    get(action) {
+        return httpRequest(this.baseUrl, 'GET', `/browser/${this.sessionId}/${action}`);
+    }
+}
+exports.BrowserProxySession = BrowserProxySession;
+/**
+ * Proxy Map that delegates variable operations to the local HTTP server.
+ * Provides a synchronous get() that uses a local cache, refreshed by the proxy session methods.
+ */
+class ProxyVariableMap {
+    baseUrl;
+    sessionId;
+    cache = new Map();
+    constructor(baseUrl, sessionId) {
+        this.baseUrl = baseUrl;
+        this.sessionId = sessionId;
+    }
+    get(name) {
+        return this.cache.get(name);
+    }
+    set(name, value) {
+        this.cache.set(name, value);
+        // Fire-and-forget to the server
+        httpRequest(this.baseUrl, 'POST', `/browser/${this.sessionId}/variable`, JSON.stringify({ name, value }))
+            .catch((err) => { logger_1.logger.warn(`[proxy-variable] Failed to sync variable "${name}" to server: ${String(err)}`); });
+        return this;
+    }
+    entries() {
+        return this.cache.entries();
+    }
+    /** Refresh cache from the server. Call before reading variables. */
+    async refresh() {
+        const result = await httpRequest(this.baseUrl, 'GET', `/browser/${this.sessionId}/variables`);
+        const vars = (result.variables ?? {});
+        this.cache.clear();
+        for (const [k, v] of Object.entries(vars)) {
+            this.cache.set(k, v);
+        }
+    }
+}
+function httpRequest(baseUrl, method, path, body) {
+    return new Promise((resolve, reject) => {
+        const url = new URL(path, baseUrl);
+        const options = {
+            hostname: url.hostname,
+            port: url.port,
+            path: url.pathname,
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        };
+        const req = http_1.default.request(options, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                const responseBody = Buffer.concat(chunks).toString();
+                try {
+                    const json = JSON.parse(responseBody);
+                    if (res.statusCode && res.statusCode >= 400) {
+                        reject(new Error(json.error ?? `HTTP ${res.statusCode}`));
+                    }
+                    else {
+                        resolve(json);
+                    }
+                }
+                catch {
+                    reject(new Error(`Invalid JSON response: ${responseBody}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.setTimeout(60000, () => {
+            req.destroy(new Error('Request timeout'));
+        });
+        if (body) {
+            req.write(body);
+        }
+        req.end();
+    });
+}
+//# sourceMappingURL=browser-proxy-session.js.map

package/dist/mcp/tools/browser/browser-proxy-session.js.map

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

package/dist/mcp/tools/browser/browser-security.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser URL security validation.
+ */
+/**
+ * Validate a URL for browser navigation.
+ * Blocks dangerous protocols (file://, javascript://, data://).
+ * In Phase 3, URL whitelist from project settings will be enforced here.
+ */
+export declare function validateUrl(url: string): {
+    valid: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=browser-security.d.ts.map

package/dist/mcp/tools/browser/browser-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-security.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/browser/browser-security.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAc5E"}

package/dist/mcp/tools/browser/browser-security.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Browser URL security validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateUrl = validateUrl;
+const browser_types_1 = require("./browser-types");
+/**
+ * Validate a URL for browser navigation.
+ * Blocks dangerous protocols (file://, javascript://, data://).
+ * In Phase 3, URL whitelist from project settings will be enforced here.
+ */
+function validateUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return { valid: false, reason: `Invalid URL: ${url}` };
+    }
+    const protocol = parsed.protocol.toLowerCase();
+    if (browser_types_1.BLOCKED_PROTOCOLS.includes(protocol)) {
+        return { valid: false, reason: `Blocked protocol: ${protocol} — only http: and https: are allowed` };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=browser-security.js.map

package/dist/mcp/tools/browser/browser-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-security.js","sourceRoot":"","sources":["../../../../src/mcp/tools/browser/browser-security.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,kCAcC;AArBD,mDAAmD;AAEnD;;;;GAIG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAA;IACxD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;IAC9C,IAAI,iCAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,QAAQ,sCAAsC,EAAE,CAAA;IACtG,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACxB,CAAC"}

package/dist/mcp/tools/browser/browser-session-manager.d.ts

@@ -0,0 +1,50 @@
+/**
+ * BrowserSessionManager — manages multiple browser sessions for live view.
+ */
+import { BrowserSession } from './browser-session';
+export declare class BrowserSessionManager {
+    private sessions;
+    private conversationMap;
+    private readonly maxSessions;
+    constructor(maxSessions?: number);
+    /**
+     * Get an existing session or create a new one.
+     */
+    getOrCreate(sessionId: string): Promise<BrowserSession>;
+    /**
+     * Get an existing session by session ID.
+     */
+    get(sessionId: string): BrowserSession | undefined;
+    /**
+     * Get a session by conversation ID.
+     */
+    getByConversationId(conversationId: string): BrowserSession | undefined;
+    /**
+     * Get the session ID for a given conversation ID.
+     */
+    getSessionIdByConversationId(conversationId: string): string | undefined;
+    /**
+     * Link a conversation to a session.
+     */
+    linkConversation(conversationId: string, sessionId: string): void;
+    /**
+     * Close and remove a session.
+     */
+    close(sessionId: string): Promise<void>;
+    /**
+     * Close all sessions.
+     */
+    closeAll(): Promise<void>;
+    /**
+     * List all active sessions.
+     */
+    listSessions(): Array<{
+        sessionId: string;
+        conversationId?: string;
+    }>;
+    /**
+     * Get the number of active sessions.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=browser-session-manager.d.ts.map

package/dist/mcp/tools/browser/browser-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session-manager.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/browser/browser-session-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,WAAW,GAAE,MAAU;IAInC;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAc7D;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD;;OAEG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAMvE;;OAEG;IACH,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxE;;OAEG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKjE;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBrE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/mcp/tools/browser/browser-session-manager.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * BrowserSessionManager — manages multiple browser sessions for live view.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserSessionManager = void 0;
+const logger_1 = require("../../../logger");
+const browser_session_1 = require("./browser-session");
+class BrowserSessionManager {
+    sessions = new Map();
+    conversationMap = new Map(); // conversationId → sessionId
+    maxSessions;
+    constructor(maxSessions = 3) {
+        this.maxSessions = maxSessions;
+    }
+    /**
+     * Get an existing session or create a new one.
+     */
+    async getOrCreate(sessionId) {
+        const existing = this.sessions.get(sessionId);
+        if (existing)
+            return existing;
+        if (this.sessions.size >= this.maxSessions) {
+            throw new Error(`Max browser sessions reached (${this.maxSessions})`);
+        }
+        const session = new browser_session_1.BrowserSession();
+        this.sessions.set(sessionId, session);
+        logger_1.logger.debug(`[browser-manager] Session created: ${sessionId}`);
+        return session;
+    }
+    /**
+     * Get an existing session by session ID.
+     */
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get a session by conversation ID.
+     */
+    getByConversationId(conversationId) {
+        const sessionId = this.conversationMap.get(conversationId);
+        if (!sessionId)
+            return undefined;
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get the session ID for a given conversation ID.
+     */
+    getSessionIdByConversationId(conversationId) {
+        return this.conversationMap.get(conversationId);
+    }
+    /**
+     * Link a conversation to a session.
+     */
+    linkConversation(conversationId, sessionId) {
+        this.conversationMap.set(conversationId, sessionId);
+        logger_1.logger.debug(`[browser-manager] Linked conversation ${conversationId} → session ${sessionId}`);
+    }
+    /**
+     * Close and remove a session.
+     */
+    async close(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        await session.close();
+        this.sessions.delete(sessionId);
+        // Remove conversation mappings pointing to this session
+        for (const [convId, sid] of this.conversationMap) {
+            if (sid === sessionId) {
+                this.conversationMap.delete(convId);
+            }
+        }
+        logger_1.logger.debug(`[browser-manager] Session closed: ${sessionId}`);
+    }
+    /**
+     * Close all sessions.
+     */
+    async closeAll() {
+        const sessionIds = Array.from(this.sessions.keys());
+        for (const sessionId of sessionIds) {
+            await this.close(sessionId);
+        }
+    }
+    /**
+     * List all active sessions.
+     */
+    listSessions() {
+        const result = [];
+        // Build reverse map of sessionId → conversationId
+        const reverseMap = new Map();
+        for (const [convId, sessId] of this.conversationMap) {
+            reverseMap.set(sessId, convId);
+        }
+        for (const sessionId of this.sessions.keys()) {
+            result.push({
+                sessionId,
+                conversationId: reverseMap.get(sessionId),
+            });
+        }
+        return result;
+    }
+    /**
+     * Get the number of active sessions.
+     */
+    get size() {
+        return this.sessions.size;
+    }
+}
+exports.BrowserSessionManager = BrowserSessionManager;
+//# sourceMappingURL=browser-session-manager.js.map

package/dist/mcp/tools/browser/browser-session-manager.js.map

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

package/dist/mcp/tools/browser/browser-session.d.ts

@@ -0,0 +1,93 @@
+/**
+ * BrowserSession — Playwright wrapper managing a singleton browser + page.
+ * Auto-closes after idle timeout (5 minutes).
+ * Supports live view streaming (JPEG frames) and direct interaction.
+ */
+import { BrowserActionLog } from './browser-action-log';
+type Page = any;
+export declare class BrowserSession {
+    private browser;
+    private page;
+    private idleTimer;
+    private readonly idleTimeoutMs;
+    private liveViewInterval;
+    /** Session-scoped temporary variables */
+    readonly variables: Map<string, string>;
+    /** Action log for recording browser operations */
+    readonly actionLog: BrowserActionLog;
+    constructor(idleTimeoutMs?: number);
+    /**
+     * Get the current page, launching browser if needed.
+     */
+    getPage(): Promise<Page>;
+    /**
+     * Check if a browser session is currently active.
+     */
+    isActive(): boolean;
+    /**
+     * Close the browser and clean up resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Set the viewport size for the current page.
+     */
+    setViewport(width: number, height: number): Promise<void>;
+    /**
+     * Take a screenshot of the current page.
+     */
+    screenshot(fullPage?: boolean): Promise<Buffer>;
+    /**
+     * Start live view streaming. Takes JPEG screenshots at the specified interval
+     * and calls the onFrame callback with the base64-encoded data.
+     * While live view is active, the idle timeout is disabled.
+     */
+    startLiveView(intervalMs: number, onFrame: (base64: string) => void): void;
+    /**
+     * Stop live view streaming and re-enable idle timeout.
+     */
+    stopLiveView(): void;
+    /**
+     * Check if live view is currently active.
+     */
+    isLiveViewActive(): boolean;
+    /**
+     * Click at the specified coordinates.
+     */
+    executeMouseClick(x: number, y: number, button?: string, clickCount?: number): Promise<void>;
+    /**
+     * Scroll the page.
+     */
+    executeMouseWheel(deltaX: number, deltaY: number): Promise<void>;
+    /**
+     * Type text into the focused element.
+     */
+    executeKeyboardType(text: string): Promise<void>;
+    /**
+     * Press a key combination.
+     */
+    executeKeyboardPress(key: string, modifiers?: string[]): Promise<void>;
+    /**
+     * Navigate back.
+     */
+    goBack(): Promise<void>;
+    /**
+     * Navigate forward.
+     */
+    goForward(): Promise<void>;
+    /**
+     * Reload the page.
+     */
+    reload(): Promise<void>;
+    /**
+     * Get current page URL.
+     */
+    getCurrentUrl(): string;
+    /**
+     * Get current page title.
+     */
+    getPageTitle(): Promise<string>;
+    private resetIdleTimer;
+    private clearIdleTimer;
+}
+export {};
+//# sourceMappingURL=browser-session.d.ts.map

package/dist/mcp/tools/browser/browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/browser/browser-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AASvD,KAAK,IAAI,GAAG,GAAG,CAAA;AAEf,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,yCAAyC;IACzC,QAAQ,CAAC,SAAS,sBAA4B;IAE9C,kDAAkD;IAClD,QAAQ,CAAC,SAAS,mBAAyB;gBAE/B,aAAa,GAAE,MAAgC;IAI3D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D;;OAEG;IACG,UAAU,CAAC,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3D;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAuB1E;;OAEG;IACH,YAAY,IAAI,IAAI;IAYpB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAM3B;;OAEG;IACG,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtE;;OAEG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD;;OAEG;IACG,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5E;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;OAEG;IACH,aAAa,IAAI,MAAM;IAKvB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,cAAc;CAMvB"}