@agent-relay/browser-primitive 4.0.9 → 4.0.40

package/dist/types.d.ts

@@ -0,0 +1,364 @@
+import type { Browser as PlaywrightBrowser, BrowserContext, Cookie, Locator, Page } from 'playwright';
+export type BrowserEngine = 'chromium' | 'firefox' | 'webkit';
+export type LoadState = 'load' | 'domcontentloaded' | 'networkidle' | 'commit';
+export type WaitForSelectorState = 'attached' | 'detached' | 'visible' | 'hidden';
+export interface ViewportSize {
+    width: number;
+    height: number;
+}
+export interface BrowserConfig {
+    /** Browser engine to use. Defaults to chromium. */
+    browser?: BrowserEngine;
+    /** Run in headless mode. Defaults to true. */
+    headless?: boolean;
+    /** Browser viewport dimensions. Defaults to 1280x720. */
+    viewport?: ViewportSize;
+    /** Default action and navigation timeout in milliseconds. Defaults to 30000. */
+    timeout?: number;
+    /** Custom user agent string for new contexts. */
+    userAgent?: string;
+    /** Extra HTTP headers to send with every request. */
+    extraHTTPHeaders?: Record<string, string>;
+    /** Extra browser launch arguments. */
+    args?: string[];
+    /** Capture console messages from the page. Defaults to true. */
+    captureConsole?: boolean;
+    /** Capture response metadata from the page. Defaults to false. */
+    captureNetwork?: boolean;
+    /** Keep the browser session open between actions. Defaults to true. */
+    persistSession?: boolean;
+    /** Capture a screenshot when an action fails. Defaults to false. */
+    screenshotOnError?: boolean;
+}
+export interface ElementSelectorObject {
+    /** Selector passed to Playwright's locator API. */
+    selector: string;
+    /** Optional frame selector resolved with frameLocator before locating the element. */
+    frame?: string;
+    /** Optional text filter applied to the locator. */
+    hasText?: string | RegExp;
+    /** Optional zero-based match index. */
+    index?: number;
+    /** Set false to use the first matching element instead of Playwright strict matching. */
+    strict?: boolean;
+    /** Default wait state for this selector. */
+    state?: WaitForSelectorState;
+    /** Selector-specific timeout in milliseconds. */
+    timeout?: number;
+}
+export type ElementSelector = string | ElementSelectorObject;
+export interface WaitForSelectorOptions {
+    state?: WaitForSelectorState;
+    timeout?: number;
+}
+export interface GotoParams {
+    url: string;
+    waitUntil?: LoadState;
+    timeout?: number;
+    referer?: string;
+}
+export interface HistoryNavigationParams {
+    waitUntil?: LoadState;
+    timeout?: number;
+}
+export type ReloadParams = HistoryNavigationParams;
+export interface ClickParams {
+    selector: ElementSelector;
+    waitFor?: boolean | WaitForSelectorOptions;
+    button?: 'left' | 'right' | 'middle';
+    clickCount?: number;
+    delay?: number;
+    timeout?: number;
+    force?: boolean;
+    noWaitAfter?: boolean;
+    position?: {
+        x: number;
+        y: number;
+    };
+    modifiers?: Array<'Alt' | 'Control' | 'Meta' | 'Shift'>;
+    trial?: boolean;
+}
+export interface FillParams {
+    selector: ElementSelector;
+    value: string;
+    waitFor?: boolean | WaitForSelectorOptions;
+    timeout?: number;
+    force?: boolean;
+    /** Defaults to true. When false, text is typed at the current cursor position. */
+    clear?: boolean;
+}
+export interface CheckParams {
+    selector: ElementSelector;
+    checked?: boolean;
+    waitFor?: boolean | WaitForSelectorOptions;
+    timeout?: number;
+    force?: boolean;
+    noWaitAfter?: boolean;
+    trial?: boolean;
+}
+export interface SelectParams {
+    selector: ElementSelector;
+    values: string | string[];
+    waitFor?: boolean | WaitForSelectorOptions;
+    timeout?: number;
+    force?: boolean;
+}
+export interface HoverParams {
+    selector: ElementSelector;
+    waitFor?: boolean | WaitForSelectorOptions;
+    timeout?: number;
+    force?: boolean;
+    position?: {
+        x: number;
+        y: number;
+    };
+    modifiers?: Array<'Alt' | 'Control' | 'Meta' | 'Shift'>;
+    trial?: boolean;
+}
+export interface PressParams {
+    selector: ElementSelector;
+    key: string;
+    waitFor?: boolean | WaitForSelectorOptions;
+    timeout?: number;
+    delay?: number;
+    noWaitAfter?: boolean;
+}
+export interface SubmitParams {
+    selector?: ElementSelector;
+    waitForNavigation?: boolean;
+    waitUntil?: LoadState;
+    timeout?: number;
+}
+export interface UploadParams {
+    selector: ElementSelector;
+    filePath: string | string[];
+    waitFor?: boolean | WaitForSelectorOptions;
+    timeout?: number;
+}
+export interface TextParams {
+    selector?: ElementSelector;
+    innerText?: boolean;
+    all?: boolean;
+    timeout?: number;
+}
+export interface HtmlParams {
+    selector?: ElementSelector;
+    outerHTML?: boolean;
+    timeout?: number;
+}
+export interface AttributeParams {
+    selector: ElementSelector;
+    name: string;
+    timeout?: number;
+}
+export interface ScreenshotParams {
+    selector?: ElementSelector;
+    path?: string;
+    fullPage?: boolean;
+    type?: 'png' | 'jpeg';
+    quality?: number;
+    timeout?: number;
+    omitBackground?: boolean;
+    animations?: 'allow' | 'disabled';
+    scale?: 'css' | 'device';
+}
+export interface WaitForSelectorParams extends WaitForSelectorOptions {
+    selector: ElementSelector;
+}
+export interface WaitForNavigationParams {
+    url?: string | RegExp;
+    waitUntil?: LoadState;
+    timeout?: number;
+}
+export interface WaitForFunctionParams {
+    script: string;
+    args?: unknown[];
+    timeout?: number;
+    polling?: 'raf' | number;
+}
+export interface EvaluateParams {
+    script: string;
+    args?: unknown[];
+    /** When provided, evaluates against this element. The element is passed as arg 0. */
+    selector?: ElementSelector;
+    timeout?: number;
+}
+export interface NavigationOutput {
+    url: string;
+    status: number | null;
+    ok: boolean | null;
+}
+export interface SelectorActionOutput {
+    selector: string;
+    action: string;
+}
+export interface TextOutput {
+    selector?: string;
+    text: string | string[] | null;
+}
+export interface HtmlOutput {
+    selector?: string;
+    html: string | null;
+}
+export interface AttributeOutput {
+    selector: string;
+    name: string;
+    value: string | null;
+}
+export interface ScreenshotOutput {
+    path?: string;
+    base64?: string;
+    bytes: number;
+    type: 'png' | 'jpeg';
+    fullPage?: boolean;
+    selector?: string;
+}
+export interface WaitOutput {
+    url: string;
+    selector?: string;
+    state?: WaitForSelectorState;
+    value?: unknown;
+}
+export type BrowserActionName = 'goto' | 'navigate' | 'back' | 'forward' | 'reload' | 'click' | 'fill' | 'check' | 'uncheck' | 'select' | 'hover' | 'press' | 'submit' | 'upload' | 'text' | 'getText' | 'html' | 'getHTML' | 'attribute' | 'getAttribute' | 'screenshot' | 'elementScreenshot' | 'waitForSelector' | 'waitForElement' | 'waitForNavigation' | 'waitForFunction' | 'evaluate';
+export interface BrowserActionParamsMap {
+    goto: GotoParams;
+    navigate: GotoParams;
+    back: HistoryNavigationParams;
+    forward: HistoryNavigationParams;
+    reload: ReloadParams;
+    click: ClickParams;
+    fill: FillParams;
+    check: CheckParams;
+    uncheck: Omit<CheckParams, 'checked'>;
+    select: SelectParams;
+    hover: HoverParams;
+    press: PressParams;
+    submit: SubmitParams;
+    upload: UploadParams;
+    text: TextParams;
+    getText: TextParams;
+    html: HtmlParams;
+    getHTML: HtmlParams;
+    attribute: AttributeParams;
+    getAttribute: AttributeParams;
+    screenshot: ScreenshotParams;
+    elementScreenshot: ScreenshotParams & {
+        selector: ElementSelector;
+    };
+    waitForSelector: WaitForSelectorParams;
+    waitForElement: WaitForSelectorParams;
+    waitForNavigation: WaitForNavigationParams;
+    waitForFunction: WaitForFunctionParams;
+    evaluate: EvaluateParams;
+}
+export interface BrowserActionOutputMap {
+    goto: NavigationOutput;
+    navigate: NavigationOutput;
+    back: NavigationOutput | null;
+    forward: NavigationOutput | null;
+    reload: NavigationOutput | null;
+    click: SelectorActionOutput;
+    fill: SelectorActionOutput;
+    check: SelectorActionOutput;
+    uncheck: SelectorActionOutput;
+    select: SelectorActionOutput & {
+        values: string[];
+    };
+    hover: SelectorActionOutput;
+    press: SelectorActionOutput & {
+        key: string;
+    };
+    submit: SelectorActionOutput;
+    upload: SelectorActionOutput & {
+        files: string[];
+    };
+    text: TextOutput;
+    getText: TextOutput;
+    html: HtmlOutput;
+    getHTML: HtmlOutput;
+    attribute: AttributeOutput;
+    getAttribute: AttributeOutput;
+    screenshot: ScreenshotOutput;
+    elementScreenshot: ScreenshotOutput;
+    waitForSelector: WaitOutput;
+    waitForElement: WaitOutput;
+    waitForNavigation: WaitOutput;
+    waitForFunction: WaitOutput;
+    evaluate: unknown;
+}
+export type BrowserAction<TName extends BrowserActionName = BrowserActionName> = {
+    [Name in TName]: {
+        type: Name;
+        params: BrowserActionParamsMap[Name];
+    };
+}[TName];
+export type BrowserWorkflowAction<TName extends BrowserActionName = BrowserActionName> = {
+    [Name in TName]: {
+        action: Name;
+        params: BrowserActionParamsMap[Name];
+    };
+}[TName];
+export type BrowserActionRequest<TName extends BrowserActionName = BrowserActionName> = BrowserAction<TName> | BrowserWorkflowAction<TName>;
+export interface ConsoleMessage {
+    type: 'log' | 'error' | 'warn' | 'info' | 'debug';
+    text: string;
+    timestamp: Date;
+    location?: string;
+}
+export interface NetworkRequest {
+    url: string;
+    method: string;
+    status: number;
+    responseTime: number;
+    timestamp: Date;
+    error?: string;
+}
+export interface BrowserSession {
+    id: string;
+    config: RequiredBrowserConfig;
+    currentUrl?: string;
+    cookies: Cookie[];
+    consoleLogs: ConsoleMessage[];
+    networkLogs: NetworkRequest[];
+    startTime: Date;
+    active: boolean;
+}
+export interface ActionResultMetadata {
+    action?: BrowserActionName;
+    sessionId?: string;
+    currentUrl?: string;
+    executionTime?: number;
+    startedAt?: string;
+    endedAt?: string;
+    errorScreenshot?: string;
+    consoleLogs?: ConsoleMessage[];
+    networkActivity?: NetworkRequest[];
+}
+export interface ActionResult<TOutput = unknown> {
+    success: boolean;
+    output?: TOutput;
+    error?: string;
+    metadata?: ActionResultMetadata;
+}
+export type BrowserActionResult<TOutput = unknown> = ActionResult<TOutput>;
+export interface RequiredBrowserConfig {
+    browser: BrowserEngine;
+    headless: boolean;
+    viewport: ViewportSize;
+    timeout: number;
+    userAgent?: string;
+    extraHTTPHeaders?: Record<string, string>;
+    args: string[];
+    captureConsole: boolean;
+    captureNetwork: boolean;
+    persistSession: boolean;
+    screenshotOnError: boolean;
+}
+export interface BrowserActionContext {
+    page: Page;
+    config: RequiredBrowserConfig;
+    resolveLocator(selector: ElementSelector): Locator;
+    waitForElement(selector: ElementSelector, options?: WaitForSelectorOptions): Promise<Locator>;
+}
+export type { BrowserContext, Locator, Page, PlaywrightBrowser };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/workflow-step.d.ts

@@ -0,0 +1,99 @@
+import type { RunnerStepExecutor, WorkflowStep } from '@agent-relay/sdk/workflows';
+import { BrowserClient, type BrowserClientOptions } from './browser-client.js';
+import type { ActionResult, BrowserActionName, BrowserActionParamsMap, BrowserConfig, BrowserSession } from './types.js';
+export type BrowserStepOutputMode = 'last' | 'all' | 'captures' | 'summary' | 'none';
+export type BrowserStepOutputFormat = 'json' | 'text';
+export type BrowserStepAction<TName extends BrowserActionName = BrowserActionName> = {
+    [Name in TName]: {
+        action: Name;
+        params: BrowserActionParamsMap[Name];
+        /** Stable key for captured output. Defaults to the zero-based action index. */
+        id?: string;
+        /** Include this action in output.mode = "captures". Defaults true for extraction actions. */
+        capture?: boolean;
+        /** Output object key when output.mode = "captures". Defaults to id or action_<index>. */
+        outputKey?: string;
+        /** Continue running later actions if this action fails. Defaults false. */
+        continueOnError?: boolean;
+    };
+}[TName];
+export interface BrowserStepOutputConfig {
+    /** Which action results become the workflow step output. Defaults to "last". */
+    mode?: BrowserStepOutputMode;
+    /** Emit JSON for structured chaining or text for simple downstream interpolation. Defaults to "json". */
+    format?: BrowserStepOutputFormat;
+    /** Include per-action metadata such as current URL and timing in JSON output. Defaults false. */
+    includeMetadata?: boolean;
+    /** Include final browser session state in JSON output. Defaults false. */
+    includeSession?: boolean;
+    /** Pretty-print JSON output. Defaults false. */
+    pretty?: boolean;
+}
+export interface BrowserStepConfig {
+    /** Unique step name within the workflow. */
+    name: string;
+    /** Dependencies in the Relay workflow DAG. */
+    dependsOn?: string[];
+    /** Browser settings for this step/session. */
+    config?: BrowserConfig;
+    /** Ordered browser actions to execute in one browser session. */
+    actions: BrowserStepAction[];
+    /** Controls the string captured as {{steps.<name>.output}}. */
+    output?: BrowserStepOutputConfig;
+    /** Reuse a named browser session across browser steps. Defaults to the workspace/config session. */
+    sessionId?: string;
+    /** Close the session after this step, even when persistSession is true. */
+    closeSession?: boolean;
+    /** Workflow step timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Number of retry attempts when the workflow runner retries this integration step. */
+    retries?: number;
+}
+export interface BrowserStepExecutionContext {
+    workspaceId?: string;
+    sessionId?: string;
+    client?: BrowserClient;
+}
+export interface BrowserStepActionRecord<TOutput = unknown> {
+    index: number;
+    id?: string;
+    action: BrowserActionName;
+    success: boolean;
+    output?: TOutput;
+    error?: string;
+    metadata?: ActionResult['metadata'];
+}
+export interface BrowserStepExecutionResult {
+    success: boolean;
+    output: string;
+    results: BrowserStepActionRecord[];
+    session: BrowserSession;
+    error?: string;
+}
+export interface BrowserIntegrationStepResult {
+    output: string;
+    success: boolean;
+}
+/**
+ * Create a Relay integration step that can be used in relay.yaml or passed to
+ * WorkflowRunner directly. Complex action/config objects are serialized into
+ * params so the existing workflow template resolver can interpolate them.
+ */
+export declare function createBrowserStep(config: BrowserStepConfig): WorkflowStep;
+export declare class BrowserStepExecutor implements RunnerStepExecutor {
+    private readonly options;
+    private readonly sessions;
+    constructor(options?: BrowserClientOptions);
+    executeAgentStep(): Promise<string>;
+    execute(config: BrowserStepConfig, context?: BrowserStepExecutionContext): Promise<BrowserStepExecutionResult>;
+    executeIntegrationStep(step: WorkflowStep, resolvedParams: Record<string, string>, context?: {
+        workspaceId?: string;
+    }): Promise<BrowserIntegrationStepResult>;
+    closeSession(sessionId: string): Promise<boolean>;
+    closeAll(): Promise<void>;
+    listSessions(): BrowserSession[];
+    private getOrCreateClient;
+    private resolveSessionKey;
+}
+export declare function browserStepConfigFromWorkflowStep(step: WorkflowStep, resolvedParams: Record<string, string>): BrowserStepConfig;
+//# sourceMappingURL=workflow-step.d.ts.map

package/dist/workflow-step.d.ts.map

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