@relayflows/core 0.0.1 → 1.0.0

package/dist/integrations/browser.js

@@ -0,0 +1,419 @@
+import { BrowserClient } from '@relayflows/browser-primitive';
+const BROWSER_INTEGRATION = 'browser';
+const BROWSER_RUN_ACTION = 'run';
+const EXTRACTION_ACTIONS = new Set([
+    'text',
+    'getText',
+    'html',
+    'getHTML',
+    'attribute',
+    'getAttribute',
+    'screenshot',
+    'elementScreenshot',
+    'evaluate',
+]);
+/**
+ * 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 function createBrowserStep(config) {
+    validateBrowserStepConfig(config);
+    const params = {
+        actions: JSON.stringify(config.actions),
+    };
+    if (config.config !== undefined) {
+        params.config = JSON.stringify(config.config);
+    }
+    if (config.output !== undefined) {
+        params.output = JSON.stringify(config.output);
+    }
+    if (config.sessionId !== undefined) {
+        params.sessionId = config.sessionId;
+    }
+    if (config.closeSession !== undefined) {
+        params.closeSession = String(config.closeSession);
+    }
+    const step = {
+        name: config.name,
+        type: 'integration',
+        integration: BROWSER_INTEGRATION,
+        action: BROWSER_RUN_ACTION,
+        params,
+    };
+    if (config.dependsOn !== undefined)
+        step.dependsOn = config.dependsOn;
+    if (config.timeoutMs !== undefined)
+        step.timeoutMs = config.timeoutMs;
+    if (config.retries !== undefined)
+        step.retries = config.retries;
+    return step;
+}
+export class BrowserStepExecutor {
+    options;
+    sessions = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async executeAgentStep() {
+        throw new Error('BrowserStepExecutor only executes browser integration steps.');
+    }
+    async execute(config, context = {}) {
+        validateBrowserStepConfig(config);
+        const client = context.client ?? this.getOrCreateClient(config, context);
+        const records = [];
+        let hardFailure;
+        for (let index = 0; index < config.actions.length; index += 1) {
+            const action = config.actions[index];
+            const started = Date.now();
+            const result = await client.executeWorkflowAction(action);
+            const record = {
+                index,
+                id: action.id,
+                action: action.action,
+                success: result.success,
+                output: result.output,
+                error: result.error,
+                metadata: result.metadata,
+            };
+            records.push(record);
+            if (!result.success && !action.continueOnError) {
+                hardFailure = record;
+                break;
+            }
+            if (!record.metadata) {
+                record.metadata = {
+                    action: action.action,
+                    sessionId: client.getSession().id,
+                    currentUrl: client.getCurrentUrl(),
+                    executionTime: Date.now() - started,
+                };
+            }
+        }
+        const session = client.getSession();
+        const output = formatStepOutput(config, records, session);
+        const success = hardFailure === undefined;
+        if (config.closeSession || config.config?.persistSession === false) {
+            if (context.client) {
+                await context.client.close();
+            }
+            else {
+                await this.closeSession(this.resolveSessionKey(config, context));
+            }
+        }
+        return {
+            success,
+            output,
+            results: records,
+            session,
+            error: hardFailure?.error,
+        };
+    }
+    async executeIntegrationStep(step, resolvedParams, context = {}) {
+        if (step.integration !== BROWSER_INTEGRATION) {
+            return {
+                success: false,
+                output: `BrowserStepExecutor only handles "${BROWSER_INTEGRATION}" integration steps`,
+            };
+        }
+        try {
+            const config = browserStepConfigFromWorkflowStep(step, resolvedParams);
+            const result = await this.execute(config, context);
+            return {
+                success: result.success,
+                output: result.success ? result.output : result.output || result.error || 'Browser step failed',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async closeSession(sessionId) {
+        const client = this.sessions.get(sessionId);
+        if (!client) {
+            return false;
+        }
+        await client.close();
+        this.sessions.delete(sessionId);
+        return true;
+    }
+    async closeAll() {
+        await Promise.all([...this.sessions.values()].map((client) => client.close()));
+        this.sessions.clear();
+    }
+    listSessions() {
+        return [...this.sessions.values()].map((client) => client.getSession());
+    }
+    getOrCreateClient(config, context) {
+        const key = this.resolveSessionKey(config, context);
+        const existing = this.sessions.get(key);
+        if (existing) {
+            return existing;
+        }
+        const client = new BrowserClient({
+            ...this.options,
+            config: {
+                ...this.options.config,
+                ...config.config,
+            },
+        });
+        this.sessions.set(key, client);
+        return client;
+    }
+    resolveSessionKey(config, context) {
+        if (context.sessionId)
+            return context.sessionId;
+        if (config.sessionId)
+            return config.sessionId;
+        const workspace = context.workspaceId ?? 'default';
+        return `${workspace}:${stableStringify(config.config ?? {})}`;
+    }
+}
+export function browserStepConfigFromWorkflowStep(step, resolvedParams) {
+    const params = normalizeResolvedParams(resolvedParams);
+    const config = readJsonParam(params.config ?? params.browserConfig, 'config') ?? undefined;
+    const output = readJsonParam(params.output, 'output') ?? undefined;
+    const closeSession = params.closeSession === undefined ? undefined : Boolean(coerceScalar(params.closeSession));
+    const sessionId = params.sessionId === undefined ? undefined : String(params.sessionId);
+    const actions = readActions(step, params);
+    return {
+        name: step.name,
+        dependsOn: step.dependsOn,
+        config,
+        actions,
+        output,
+        sessionId,
+        closeSession,
+        timeoutMs: step.timeoutMs,
+        retries: step.retries,
+    };
+}
+function validateBrowserStepConfig(config) {
+    if (!config.name) {
+        throw new Error('Browser step requires a non-empty name');
+    }
+    if (!Array.isArray(config.actions) || config.actions.length === 0) {
+        throw new Error(`Browser step "${config.name}" requires at least one action`);
+    }
+    for (const [index, action] of config.actions.entries()) {
+        if (!action || typeof action !== 'object') {
+            throw new Error(`Browser step "${config.name}" action ${index} must be an object`);
+        }
+        if (!action.action || typeof action.action !== 'string') {
+            throw new Error(`Browser step "${config.name}" action ${index} requires an action name`);
+        }
+        if (action.params === undefined || typeof action.params !== 'object' || action.params === null) {
+            throw new Error(`Browser step "${config.name}" action ${index} requires params`);
+        }
+    }
+}
+function readActions(step, params) {
+    const serializedActions = params.actions;
+    if (serializedActions !== undefined) {
+        const parsed = readJsonParam(serializedActions, 'actions');
+        if (!Array.isArray(parsed)) {
+            throw new Error('Browser step params.actions must be a JSON array');
+        }
+        return parsed;
+    }
+    if (!step.action || step.action === BROWSER_RUN_ACTION) {
+        throw new Error(`Browser step "${step.name}" requires params.actions or a browser action`);
+    }
+    const actionParams = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (key === 'config' ||
+            key === 'browserConfig' ||
+            key === 'output' ||
+            key === 'sessionId' ||
+            key === 'closeSession') {
+            continue;
+        }
+        actionParams[key] = value;
+    }
+    return [
+        {
+            action: step.action,
+            params: actionParams,
+        },
+    ];
+}
+function formatStepOutput(config, records, session) {
+    const outputConfig = config.output ?? {};
+    const mode = outputConfig.mode ?? 'last';
+    const format = outputConfig.format ?? 'json';
+    if (mode === 'none') {
+        return '';
+    }
+    const projection = buildOutputProjection(mode, config.actions, records, session, outputConfig);
+    if (format === 'text') {
+        return projectionToText(projection);
+    }
+    return JSON.stringify(projection, undefined, outputConfig.pretty ? 2 : undefined);
+}
+function buildOutputProjection(mode, actions, records, session, outputConfig) {
+    if (mode === 'summary') {
+        const failed = records.find((record) => !record.success);
+        return withOptionalSession({
+            success: failed === undefined,
+            actionCount: records.length,
+            currentUrl: session.currentUrl,
+            failedAction: failed
+                ? {
+                    index: failed.index,
+                    id: failed.id,
+                    action: failed.action,
+                    error: failed.error,
+                }
+                : undefined,
+        }, session, outputConfig);
+    }
+    if (mode === 'all') {
+        return withOptionalSession({
+            results: records.map((record) => projectRecord(record, outputConfig.includeMetadata ?? false)),
+        }, session, outputConfig);
+    }
+    if (mode === 'captures') {
+        const captures = {};
+        for (const record of records) {
+            const action = record.action;
+            const actionConfig = actions[record.index];
+            const capture = actionConfig?.capture ?? (EXTRACTION_ACTIONS.has(action) && record.success);
+            if (!capture)
+                continue;
+            const key = actionConfig?.outputKey ?? actionConfig?.id ?? record.id ?? `action_${record.index}`;
+            captures[key] = projectRecord(record, outputConfig.includeMetadata ?? false);
+        }
+        return withOptionalSession({ captures }, session, outputConfig);
+    }
+    const last = records.at(-1);
+    return withOptionalSession(last ? projectRecord(last, outputConfig.includeMetadata ?? false) : null, session, outputConfig);
+}
+function projectRecord(record, includeMetadata) {
+    const projected = {
+        index: record.index,
+        action: record.action,
+        success: record.success,
+    };
+    if (record.id !== undefined)
+        projected.id = record.id;
+    if (record.output !== undefined)
+        projected.output = record.output;
+    if (record.error !== undefined)
+        projected.error = record.error;
+    if (includeMetadata && record.metadata !== undefined)
+        projected.metadata = record.metadata;
+    return projected;
+}
+function withOptionalSession(value, session, outputConfig) {
+    if (!outputConfig.includeSession) {
+        return value;
+    }
+    return {
+        value,
+        session: {
+            id: session.id,
+            active: session.active,
+            currentUrl: session.currentUrl,
+            startTime: session.startTime,
+            config: session.config,
+        },
+    };
+}
+function projectionToText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null || value === undefined)
+        return '';
+    if (isRecord(value)) {
+        if ('output' in value) {
+            return projectionToText(value.output);
+        }
+        if ('value' in value) {
+            return projectionToText(value.value);
+        }
+        if ('text' in value) {
+            return projectionToText(value.text);
+        }
+        if ('html' in value) {
+            return projectionToText(value.html);
+        }
+        if ('captures' in value) {
+            return JSON.stringify(value.captures);
+        }
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => projectionToText(entry)).join('\n');
+    }
+    return JSON.stringify(value);
+}
+function normalizeResolvedParams(params) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(params)) {
+        normalized[key] = coerceScalar(value);
+    }
+    return normalized;
+}
+function coerceScalar(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const trimmed = value.trim();
+    if (trimmed === 'true')
+        return true;
+    if (trimmed === 'false')
+        return false;
+    if (trimmed === 'null')
+        return null;
+    if (/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(trimmed))
+        return Number(trimmed);
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) ||
+        (trimmed.startsWith('[') && trimmed.endsWith(']')) ||
+        (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+function readJsonParam(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`Browser step params.${name} must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function stableStringify(value) {
+    if (!isRecord(value) && !Array.isArray(value)) {
+        return JSON.stringify(value);
+    }
+    return JSON.stringify(sortJson(value));
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortJson);
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    return Object.keys(value)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = sortJson(value[key]);
+        return acc;
+    }, {});
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=browser.js.map

package/dist/integrations/browser.js.map

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

package/dist/integrations/github.d.ts

@@ -0,0 +1,79 @@
+import type { RunnerStepExecutor, WorkflowStep } from '../types.js';
+import { GitHubClient } from '@relayflows/github-primitive';
+import type { GitHubActionName, GitHubActionParamsMap, GitHubActionResult, GitHubRuntime, GitHubRuntimeConfig, RepositoryRef } from '@relayflows/github-primitive';
+export type GitHubStepOutputMode = 'data' | 'result' | 'summary' | 'raw' | 'none';
+export type GitHubStepOutputFormat = 'json' | 'text';
+type RepoParamKeys = 'owner' | 'repo';
+type ParamsFor<TName extends GitHubActionName> = TName extends keyof GitHubActionParamsMap ? GitHubActionParamsMap[TName] : Record<string, unknown>;
+type StripRepoParams<TParams> = Omit<TParams, Extract<keyof TParams, RepoParamKeys>> & Partial<Pick<TParams, Extract<keyof TParams, RepoParamKeys>>>;
+export type GitHubStepParams<TName extends GitHubActionName = GitHubActionName> = [
+    NonNullable<ParamsFor<TName>>
+] extends [never] ? Record<string, unknown> : StripRepoParams<NonNullable<ParamsFor<TName>>>;
+export interface GitHubStepOutputConfig {
+    /** Which action result becomes the workflow step output. Defaults to "data". */
+    mode?: GitHubStepOutputMode;
+    /** Emit JSON for structured chaining or text for simple downstream interpolation. Defaults to "json". */
+    format?: GitHubStepOutputFormat;
+    /** Select a nested field from the projected output, e.g. "number" or "data.htmlUrl". */
+    path?: string;
+    /** Include adapter metadata such as runtime and timing in JSON output. Defaults false. */
+    includeMetadata?: boolean;
+    /** Include the selected runtime in JSON output. Defaults false. */
+    includeRuntime?: boolean;
+    /** Pretty-print JSON output. Defaults false. */
+    pretty?: boolean;
+}
+export interface GitHubStepConfig<TName extends GitHubActionName = GitHubActionName> {
+    /** Unique step name within the workflow. */
+    name: string;
+    /** Dependencies in the Relay workflow DAG. */
+    dependsOn?: string[];
+    /** GitHub action to execute. */
+    action: TName;
+    /** Repository in owner/repo format. Used as owner and repo params for repository-scoped actions. */
+    repo?: string | RepositoryRef;
+    /** Action-specific parameters. Values may include workflow templates such as {{steps.plan.output}}. */
+    params?: GitHubStepParams<TName>;
+    /** Runtime settings for local gh CLI, cloud/Nango, or auto detection. */
+    config?: GitHubRuntimeConfig;
+    /** Controls the string captured as {{steps.<name>.output}}. */
+    output?: GitHubStepOutputConfig;
+    /** Workflow step timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Number of retry attempts when the workflow runner retries this integration step. */
+    retries?: number;
+}
+export interface GitHubStepExecutionContext {
+    workspaceId?: string;
+    client?: GitHubClient;
+    config?: GitHubRuntimeConfig;
+}
+export interface GitHubStepExecutionResult<TOutput = unknown> {
+    success: boolean;
+    output: string;
+    result: GitHubActionResult<TOutput>;
+    runtime?: GitHubRuntime;
+    error?: string;
+}
+export interface GitHubIntegrationStepResult {
+    output: string;
+    success: boolean;
+}
+/**
+ * Create a Relay integration step that can be used in TypeScript workflows or
+ * emitted into .relay YAML. Complex params/config objects are serialized so the
+ * workflow template resolver can interpolate values before execution.
+ */
+export declare function createGitHubStep<TName extends GitHubActionName>(config: GitHubStepConfig<TName>): WorkflowStep;
+export declare class GitHubStepExecutor implements RunnerStepExecutor {
+    private readonly options;
+    constructor(options?: GitHubRuntimeConfig);
+    executeAgentStep(): Promise<string>;
+    execute<TOutput = unknown>(config: GitHubStepConfig, context?: GitHubStepExecutionContext): Promise<GitHubStepExecutionResult<TOutput>>;
+    executeIntegrationStep(step: WorkflowStep, resolvedParams: Record<string, string>, context?: {
+        workspaceId?: string;
+    }): Promise<GitHubIntegrationStepResult>;
+}
+export declare function githubStepConfigFromWorkflowStep(step: WorkflowStep, resolvedParams: Record<string, string>): GitHubStepConfig;
+export {};
+//# sourceMappingURL=github.d.ts.map

package/dist/integrations/github.d.ts.map

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