@runflow-ai/sdk 1.0.99 → 1.0.200

package/dist/rpa/actions.js

@@ -0,0 +1,214 @@
+"use strict";
+// ============================================================================
+// RPA ACTIONS - High-level helpers for common browser automation patterns
+// ============================================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.login = login;
+exports.fillForm = fillForm;
+exports.clickButton = clickButton;
+exports.waitAndClick = waitAndClick;
+exports.extractTable = extractTable;
+exports.extractText = extractText;
+exports.downloadFile = downloadFile;
+exports.screenshotPage = screenshotPage;
+exports.waitForResponse = waitForResponse;
+/**
+ * Fill a login form and submit.
+ * Supports custom selectors or defaults to common patterns.
+ */
+async function login(page, config) {
+    await page.goto(config.url, { waitUntil: 'domcontentloaded' });
+    if (config.usernameSelector) {
+        await page.locator(config.usernameSelector).fill(config.username);
+    }
+    else {
+        await page.getByRole('textbox').first().fill(config.username);
+    }
+    if (config.passwordSelector) {
+        await page.locator(config.passwordSelector).fill(config.password);
+    }
+    else {
+        const textboxes = page.getByRole('textbox');
+        const count = await textboxes.count();
+        if (count >= 2) {
+            await textboxes.nth(1).fill(config.password);
+        }
+        else {
+            await page.locator('input[type="password"]').fill(config.password);
+        }
+    }
+    if (config.submitSelector) {
+        await page.locator(config.submitSelector).click();
+    }
+    else {
+        const loginButton = page.getByRole('button', { name: /login|entrar|sign.?in|acessar/i });
+        await loginButton.click();
+    }
+    if (config.waitAfterLogin) {
+        const timeout = config.timeout ?? 30000;
+        if (config.waitAfterLogin instanceof RegExp) {
+            await page.waitForURL(config.waitAfterLogin, { timeout });
+        }
+        else {
+            await page.waitForURL(config.waitAfterLogin, { timeout });
+        }
+    }
+}
+/**
+ * Fill multiple form fields using flexible selectors.
+ */
+async function fillForm(page, fields) {
+    for (const field of fields) {
+        const locator = resolveLocator(page, field);
+        switch (field.type ?? 'fill') {
+            case 'fill':
+                await locator.fill(field.value);
+                break;
+            case 'select':
+                await locator.selectOption(field.value);
+                break;
+            case 'check':
+                await locator.check();
+                break;
+            case 'uncheck':
+                await locator.uncheck();
+                break;
+        }
+    }
+}
+/**
+ * Click a button by its accessible label.
+ */
+async function clickButton(page, label) {
+    await page.getByRole('button', { name: new RegExp(label, 'i') }).click();
+}
+/**
+ * Wait for a selector to appear and then click it.
+ */
+async function waitAndClick(page, selector, timeout) {
+    await page.waitForSelector(selector, { timeout: timeout ?? 30000 });
+    await page.locator(selector).click();
+}
+/**
+ * Extract an HTML table into an array of key-value objects.
+ * Keys are taken from <th> cells; values from <td> cells.
+ */
+async function extractTable(page, selector) {
+    return page.evaluate((sel) => {
+        const table = document.querySelector(sel);
+        if (!table)
+            return [];
+        const headers = [];
+        table.querySelectorAll('thead th, tr:first-child th').forEach((th) => {
+            headers.push(th.textContent?.trim() ?? '');
+        });
+        const rows = [];
+        const bodyRows = table.querySelectorAll('tbody tr, tr:not(:first-child)');
+        bodyRows.forEach((tr) => {
+            const cells = tr.querySelectorAll('td');
+            if (cells.length === 0)
+                return;
+            const row = {};
+            cells.forEach((td, i) => {
+                const key = headers[i] || `col_${i}`;
+                row[key] = td.textContent?.trim() ?? '';
+            });
+            rows.push(row);
+        });
+        return rows;
+    }, selector);
+}
+/**
+ * Extract text content from matched elements.
+ */
+async function extractText(page, selector) {
+    return page.evaluate((sel) => {
+        const elements = document.querySelectorAll(sel);
+        return Array.from(elements).map((el) => el.textContent?.trim() ?? '');
+    }, selector);
+}
+/**
+ * Trigger a download by clicking an element, and wait for the download to complete.
+ * Returns the downloaded file path.
+ */
+async function downloadFile(page, triggerSelector, downloadDir) {
+    const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+    fs.mkdirSync(downloadDir, { recursive: true });
+    const [download] = await Promise.all([
+        page.waitForEvent('download'),
+        page.locator(triggerSelector).click(),
+    ]);
+    const filePath = `${downloadDir}/${download.suggestedFilename()}`;
+    await download.saveAs(filePath);
+    return filePath;
+}
+/**
+ * Take a full-page screenshot and return the file path.
+ */
+async function screenshotPage(page, outputPath) {
+    const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+    const path = await Promise.resolve().then(() => __importStar(require('path')));
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    await page.screenshot({ path: outputPath, fullPage: true });
+    return outputPath;
+}
+/**
+ * Wait for a network response matching a URL pattern.
+ */
+async function waitForResponse(page, urlPattern, timeout) {
+    return page.waitForResponse((response) => {
+        const url = response.url();
+        return urlPattern instanceof RegExp ? urlPattern.test(url) : url.includes(urlPattern);
+    }, { timeout: timeout ?? 30000 });
+}
+function resolveLocator(page, field) {
+    if (field.selector) {
+        return page.locator(field.selector);
+    }
+    if (field.role && field.label) {
+        const locator = page.getByRole(field.role, { name: new RegExp(field.label, 'i') });
+        return field.nth !== undefined ? locator.nth(field.nth) : locator;
+    }
+    if (field.role) {
+        const locator = page.getByRole(field.role);
+        return field.nth !== undefined ? locator.nth(field.nth) : locator;
+    }
+    if (field.label) {
+        return page.getByLabel(new RegExp(field.label, 'i'));
+    }
+    throw new Error(`FormField must have at least one of: selector, role, or label`);
+}
+//# sourceMappingURL=actions.js.map

package/dist/rpa/actions.js.map

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

package/dist/rpa/browser-session.d.ts

@@ -0,0 +1,70 @@
+export interface BrowserSessionConfig {
+    headless?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeout?: number;
+    acceptDownloads?: boolean;
+    slowMo?: number;
+    screenshotsDir?: string;
+    userAgent?: string;
+    locale?: string;
+    timezoneId?: string;
+    extraHTTPHeaders?: Record<string, string>;
+}
+export interface BrowserSessionArtifact {
+    type: 'screenshot' | 'download' | 'pdf';
+    name: string;
+    path: string;
+    timestamp: number;
+}
+export interface BrowserActionSpan {
+    action: string;
+    selector?: string;
+    url?: string;
+    startedAt: number;
+    completedAt?: number;
+    durationMs?: number;
+    error?: string;
+}
+export declare class BrowserSession {
+    private browser;
+    private context;
+    private _page;
+    private _config;
+    private _artifacts;
+    private _actionSpans;
+    private _launched;
+    constructor(config?: BrowserSessionConfig);
+    get page(): any;
+    get artifacts(): BrowserSessionArtifact[];
+    get isLaunched(): boolean;
+    get actionSpans(): BrowserActionSpan[];
+    /**
+     * Record a traced browser action. Use this to wrap any significant
+     * browser operation so it appears in observability traces.
+     */
+    traced<T>(action: string, fn: () => Promise<T>, meta?: {
+        selector?: string;
+        url?: string;
+    }): Promise<T>;
+    /**
+     * Get a summary of all traced actions for inclusion in execution traces.
+     */
+    getTraceSummary(): {
+        totalActions: number;
+        totalDurationMs: number;
+        actions: BrowserActionSpan[];
+        artifacts: BrowserSessionArtifact[];
+        errors: string[];
+    };
+    launch(configOverride?: BrowserSessionConfig): Promise<any>;
+    screenshot(name: string): Promise<string>;
+    waitForNavigation(urlPattern: RegExp, timeout?: number): Promise<void>;
+    waitForSelector(selector: string, timeout?: number): Promise<any>;
+    getContent(): Promise<string>;
+    newPage(): Promise<any>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=browser-session.d.ts.map

package/dist/rpa/browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../../src/rpa/browser-session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AASD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,CAAC,EAAE,oBAAoB;IAIzC,IAAI,IAAI,IAAI,GAAG,CAKd;IAED,IAAI,SAAS,IAAI,sBAAsB,EAAE,CAExC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,WAAW,IAAI,iBAAiB,EAAE,CAErC;IAED;;;OAGG;IACG,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAuB7G;;OAEG;IACH,eAAe,IAAI;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAC7B,SAAS,EAAE,sBAAsB,EAAE,CAAC;QACpC,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAcK,MAAM,CAAC,cAAc,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC;IAwC3D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BzC,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASjE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAO7B,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAOvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B"}

package/dist/rpa/browser-session.js

@@ -0,0 +1,213 @@
+"use strict";
+// ============================================================================
+// BROWSER SESSION - Managed Playwright browser lifecycle
+// ============================================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserSession = void 0;
+const DEFAULT_CONFIG = {
+    headless: true,
+    viewport: { width: 1440, height: 900 },
+    timeout: 30000,
+    acceptDownloads: true,
+};
+class BrowserSession {
+    constructor(config) {
+        this.browser = null;
+        this.context = null;
+        this._page = null;
+        this._artifacts = [];
+        this._actionSpans = [];
+        this._launched = false;
+        this._config = { ...DEFAULT_CONFIG, ...config };
+    }
+    get page() {
+        if (!this._page) {
+            throw new Error('BrowserSession not launched. Call launch() first.');
+        }
+        return this._page;
+    }
+    get artifacts() {
+        return [...this._artifacts];
+    }
+    get isLaunched() {
+        return this._launched;
+    }
+    get actionSpans() {
+        return [...this._actionSpans];
+    }
+    /**
+     * Record a traced browser action. Use this to wrap any significant
+     * browser operation so it appears in observability traces.
+     */
+    async traced(action, fn, meta) {
+        const span = {
+            action,
+            selector: meta?.selector,
+            url: meta?.url,
+            startedAt: Date.now(),
+        };
+        try {
+            const result = await fn();
+            span.completedAt = Date.now();
+            span.durationMs = span.completedAt - span.startedAt;
+            this._actionSpans.push(span);
+            return result;
+        }
+        catch (error) {
+            span.completedAt = Date.now();
+            span.durationMs = span.completedAt - span.startedAt;
+            span.error = error instanceof Error ? error.message : String(error);
+            this._actionSpans.push(span);
+            throw error;
+        }
+    }
+    /**
+     * Get a summary of all traced actions for inclusion in execution traces.
+     */
+    getTraceSummary() {
+        const errors = this._actionSpans
+            .filter(s => s.error)
+            .map(s => `${s.action}: ${s.error}`);
+        return {
+            totalActions: this._actionSpans.length,
+            totalDurationMs: this._actionSpans.reduce((sum, s) => sum + (s.durationMs || 0), 0),
+            actions: this._actionSpans,
+            artifacts: this._artifacts,
+            errors,
+        };
+    }
+    async launch(configOverride) {
+        if (this._launched) {
+            return this._page;
+        }
+        const config = { ...this._config, ...configOverride };
+        let playwright;
+        try {
+            playwright = await Promise.resolve().then(() => __importStar(require('playwright')));
+        }
+        catch {
+            throw new Error('Playwright is not installed. Install it with: npm install playwright && npx playwright install chromium');
+        }
+        this.browser = await playwright.chromium.launch({
+            headless: config.headless ?? DEFAULT_CONFIG.headless,
+            slowMo: config.slowMo,
+        });
+        const contextOptions = {
+            viewport: config.viewport ?? DEFAULT_CONFIG.viewport,
+            acceptDownloads: config.acceptDownloads ?? DEFAULT_CONFIG.acceptDownloads,
+        };
+        if (config.userAgent)
+            contextOptions.userAgent = config.userAgent;
+        if (config.locale)
+            contextOptions.locale = config.locale;
+        if (config.timezoneId)
+            contextOptions.timezoneId = config.timezoneId;
+        if (config.extraHTTPHeaders)
+            contextOptions.extraHTTPHeaders = config.extraHTTPHeaders;
+        this.context = await this.browser.newContext(contextOptions);
+        this.context.setDefaultTimeout(config.timeout ?? DEFAULT_CONFIG.timeout);
+        this._page = await this.context.newPage();
+        this._launched = true;
+        return this._page;
+    }
+    async screenshot(name) {
+        if (!this._page) {
+            throw new Error('BrowserSession not launched. Call launch() first.');
+        }
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        const path = await Promise.resolve().then(() => __importStar(require('path')));
+        const dir = this._config.screenshotsDir || process.cwd();
+        fs.mkdirSync(dir, { recursive: true });
+        const sanitizedName = name.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const filePath = path.join(dir, `${sanitizedName}-${Date.now()}.png`);
+        await this._page.screenshot({ path: filePath, fullPage: true });
+        this._artifacts.push({
+            type: 'screenshot',
+            name,
+            path: filePath,
+            timestamp: Date.now(),
+        });
+        return filePath;
+    }
+    async waitForNavigation(urlPattern, timeout) {
+        if (!this._page) {
+            throw new Error('BrowserSession not launched. Call launch() first.');
+        }
+        await this._page.waitForURL(urlPattern, {
+            timeout: timeout ?? this._config.timeout ?? DEFAULT_CONFIG.timeout,
+        });
+    }
+    async waitForSelector(selector, timeout) {
+        if (!this._page) {
+            throw new Error('BrowserSession not launched. Call launch() first.');
+        }
+        return this._page.waitForSelector(selector, {
+            timeout: timeout ?? this._config.timeout ?? DEFAULT_CONFIG.timeout,
+        });
+    }
+    async getContent() {
+        if (!this._page) {
+            throw new Error('BrowserSession not launched. Call launch() first.');
+        }
+        return this._page.content();
+    }
+    async newPage() {
+        if (!this.context) {
+            throw new Error('BrowserSession not launched. Call launch() first.');
+        }
+        return this.context.newPage();
+    }
+    async close() {
+        if (this.context) {
+            try {
+                await this.context.close();
+            }
+            catch { /* ignore close errors */ }
+            this.context = null;
+        }
+        if (this.browser) {
+            try {
+                await this.browser.close();
+            }
+            catch { /* ignore close errors */ }
+            this.browser = null;
+        }
+        this._page = null;
+        this._launched = false;
+    }
+}
+exports.BrowserSession = BrowserSession;
+//# sourceMappingURL=browser-session.js.map

package/dist/rpa/browser-session.js.map

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

package/dist/rpa/browser-tool.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { RunflowTool } from '../types';
+import { BrowserSession, BrowserSessionConfig } from './browser-session';
+export interface BrowserToolConfig<TInput = any, TOutput = any> {
+    id: string;
+    description: string;
+    inputSchema: z.ZodSchema<TInput>;
+    outputSchema?: z.ZodSchema<TOutput>;
+    browser?: BrowserSessionConfig;
+    execute: (params: {
+        context: TInput;
+        browser: BrowserSession;
+        projectId: string;
+        companyId: string;
+        userId?: string;
+        sessionId?: string;
+    }) => Promise<TOutput>;
+}
+export declare function createBrowserTool<TInput = any, TOutput = any>(config: BrowserToolConfig<TInput, TOutput>): RunflowTool;
+//# sourceMappingURL=browser-tool.d.ts.map

package/dist/rpa/browser-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tool.d.ts","sourceRoot":"","sources":["../../src/rpa/browser-tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAiB,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,cAAc,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAC3D,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,WAAW,CAyDb"}

package/dist/rpa/browser-tool.js

@@ -0,0 +1,116 @@
+"use strict";
+// ============================================================================
+// BROWSER TOOL - Factory for creating RPA tools with managed browser lifecycle
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBrowserTool = createBrowserTool;
+const zod_1 = require("zod");
+const browser_session_1 = require("./browser-session");
+function createBrowserTool(config) {
+    const tool = {
+        id: config.id,
+        name: config.id,
+        description: config.description,
+        parameters: zodToParameters(config.inputSchema),
+        _isBrowserTool: true,
+        execute: async (params, context) => {
+            const validatedInput = config.inputSchema.parse(params);
+            const session = new browser_session_1.BrowserSession(config.browser);
+            try {
+                await session.launch();
+                const result = await config.execute({
+                    context: validatedInput,
+                    browser: session,
+                    projectId: context.projectId,
+                    companyId: context.companyId,
+                    userId: context.userId,
+                    sessionId: context.sessionId,
+                });
+                const output = config.outputSchema ? config.outputSchema.parse(result) : result;
+                // Attach RPA trace summary to the output for observability
+                const traceSummary = session.getTraceSummary();
+                if (typeof output === 'object' && output !== null) {
+                    output._rpaTrace = {
+                        rpaUsed: true,
+                        ...traceSummary,
+                    };
+                }
+                return output;
+            }
+            catch (error) {
+                // Auto-screenshot on error when a screenshots dir is configured
+                if (config.browser?.screenshotsDir && session.isLaunched) {
+                    try {
+                        await session.screenshot('error-capture');
+                    }
+                    catch { /* best-effort error screenshot */ }
+                }
+                // Attach trace summary to error for debugging
+                if (error instanceof Error) {
+                    error._rpaTrace = session.getTraceSummary();
+                }
+                throw error;
+            }
+            finally {
+                await session.close();
+            }
+        },
+    };
+    return tool;
+}
+// ============================================================================
+// ZOD TO PARAMETERS (reused from tool-creator pattern)
+// ============================================================================
+function zodToParameters(schema) {
+    if (schema instanceof zod_1.z.ZodObject) {
+        const shape = schema.shape;
+        const parameters = {};
+        for (const [key, fieldSchema] of Object.entries(shape)) {
+            parameters[key] = zodFieldToParameter(fieldSchema);
+        }
+        return parameters;
+    }
+    if (schema._def && schema._def.typeName === 'ZodObject') {
+        const shape = schema.shape;
+        const parameters = {};
+        for (const [key, fieldSchema] of Object.entries(shape)) {
+            parameters[key] = zodFieldToParameter(fieldSchema);
+        }
+        return parameters;
+    }
+    return { input: zodFieldToParameter(schema) };
+}
+function zodFieldToParameter(schema) {
+    if (schema instanceof zod_1.z.ZodString) {
+        const param = { type: 'string', description: schema.description };
+        if ('_def' in schema && 'values' in schema._def) {
+            param.enum = schema._def.values;
+        }
+        return param;
+    }
+    if (schema instanceof zod_1.z.ZodEnum) {
+        return { type: 'string', description: schema.description, enum: schema._def.values };
+    }
+    if (schema instanceof zod_1.z.ZodNumber) {
+        return { type: 'number', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodBoolean) {
+        return { type: 'boolean', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodArray) {
+        return { type: 'array', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodObject) {
+        return { type: 'object', description: schema.description };
+    }
+    if (schema instanceof zod_1.z.ZodOptional) {
+        const param = zodFieldToParameter(schema._def.innerType);
+        param.required = false;
+        return param;
+    }
+    if (schema instanceof zod_1.z.ZodDefault) {
+        return zodFieldToParameter(schema._def.innerType);
+    }
+    return { type: 'string', description: schema.description || 'Parameter' };
+}
+//# sourceMappingURL=browser-tool.js.map