@showrun/core 0.1.0

package/dist/runner.d.ts

@@ -0,0 +1,62 @@
+import type { TaskPack, RunResult } from './types.js';
+import type { Logger } from './types.js';
+/**
+ * Options for running a task pack
+ */
+export interface RunTaskPackOptions {
+    /**
+     * Directory to store run artifacts and logs
+     */
+    runDir: string;
+    /**
+     * Logger instance for structured logging
+     */
+    logger: Logger;
+    /**
+     * Whether to run browser in headless mode (default: true)
+     */
+    headless?: boolean;
+    /**
+     * Session ID for "once" step caching (session scope)
+     */
+    sessionId?: string;
+    /**
+     * Profile ID for "once" step caching (profile scope)
+     */
+    profileId?: string;
+    /**
+     * Directory for profile cache storage (typically the pack directory)
+     */
+    cacheDir?: string;
+    /**
+     * Pack directory path (used for loading secrets)
+     */
+    packPath?: string;
+    /**
+     * Pre-loaded secrets (if not provided, will be loaded from packPath)
+     */
+    secrets?: Record<string, string>;
+}
+/**
+ * Result of running a task pack with paths
+ */
+export interface RunTaskPackResult extends RunResult {
+    /**
+     * Path to the run directory
+     */
+    runDir: string;
+    /**
+     * Path to the events JSONL file
+     */
+    eventsPath: string;
+    /**
+     * Path to the artifacts directory
+     */
+    artifactsDir: string;
+}
+/**
+ * Runs a task pack with Playwright
+ * This is a reusable function that can be used by both CLI and MCP server
+ */
+export declare function runTaskPack(taskPack: TaskPack, inputs: Record<string, unknown>, options: RunTaskPackOptions): Promise<RunTaskPackResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA6L5B"}

package/dist/runner.js

@@ -0,0 +1,170 @@
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { InputValidator, RunContextFactory, runFlow, attachNetworkCapture, TaskPackLoader } from './index.js';
+import { launchBrowser } from './browserLauncher.js';
+/**
+ * Runs a task pack with Playwright
+ * This is a reusable function that can be used by both CLI and MCP server
+ */
+export async function runTaskPack(taskPack, inputs, options) {
+    const { runDir, logger, headless: requestedHeadless = true, packPath, secrets: providedSecrets } = options;
+    const artifactsDir = join(runDir, 'artifacts');
+    const eventsPath = join(runDir, 'events.jsonl');
+    // Load secrets from pack directory if not provided and packPath is given
+    const secrets = providedSecrets ?? (packPath ? TaskPackLoader.loadSecrets(packPath) : {});
+    // Ensure directories exist
+    mkdirSync(runDir, { recursive: true });
+    mkdirSync(artifactsDir, { recursive: true });
+    // Auto-detect if we can run headful (check for DISPLAY)
+    // If headful was requested but no DISPLAY is available, fall back to headless
+    const hasDisplay = !!process.env.DISPLAY;
+    const headless = requestedHeadless || !hasDisplay;
+    if (!requestedHeadless && !hasDisplay) {
+        console.error('[Warning] Headful mode requested but no DISPLAY environment variable found. ' +
+            'Falling back to headless mode. Set DISPLAY or use xvfb-run to enable headful mode.');
+    }
+    const startTime = Date.now();
+    let browserSession = null;
+    let page = null;
+    let runContext = null;
+    try {
+        // Apply defaults and validate inputs
+        const inputsWithDefaults = InputValidator.applyDefaults(inputs, taskPack.inputs);
+        InputValidator.validate(inputsWithDefaults, taskPack.inputs);
+        // Log run start
+        logger.log({
+            type: 'run_started',
+            data: {
+                packId: taskPack.metadata.id,
+                packVersion: taskPack.metadata.version,
+                inputs: inputsWithDefaults,
+            },
+        });
+        // Launch browser with unified launcher
+        browserSession = await launchBrowser({
+            browserSettings: taskPack.browser,
+            headless,
+            sessionId: options.sessionId,
+            packPath: options.packPath ?? options.cacheDir,
+        });
+        page = browserSession.page;
+        // Attach network capture (rolling buffer, redacted for logs; full headers in-memory for replay only)
+        const networkCapture = attachNetworkCapture(page);
+        // Create run context
+        // Note: browserSession.browser may be null for persistent contexts or Camoufox
+        // We pass a proxy that satisfies the Browser type for the RunContext
+        const browserProxy = browserSession.browser ?? {
+            close: async () => browserSession?.close(),
+            contexts: () => [browserSession?.context],
+            isConnected: () => true,
+            newContext: async () => browserSession?.context,
+            newPage: async () => browserSession?.page,
+            version: () => 'unknown',
+        };
+        runContext = RunContextFactory.create(page, browserProxy, logger, artifactsDir, networkCapture);
+        // Execute declarative DSL flow
+        const flowResult = await runFlow(runContext, taskPack.flow, {
+            inputs: inputsWithDefaults,
+            auth: taskPack.auth,
+            sessionId: options.sessionId,
+            profileId: options.profileId,
+            cacheDir: options.cacheDir,
+            secrets,
+        });
+        // Filter collectibles to only include those defined in the pack
+        // This prevents intermediate variables from polluting the output
+        const definedCollectibleNames = new Set((taskPack.collectibles || []).map(c => c.name));
+        const filteredCollectibles = {};
+        for (const [key, value] of Object.entries(flowResult.collectibles)) {
+            if (definedCollectibleNames.has(key)) {
+                filteredCollectibles[key] = value;
+            }
+        }
+        // Convert RunFlowResult to RunResult format
+        const result = {
+            collectibles: filteredCollectibles,
+            meta: {
+                url: flowResult.meta.url,
+                durationMs: flowResult.meta.durationMs,
+                notes: `Executed ${flowResult.meta.stepsExecuted}/${flowResult.meta.stepsTotal} steps`,
+            },
+        };
+        // Propagate diagnostic hints if present
+        if (flowResult._hints && flowResult._hints.length > 0) {
+            result._hints = flowResult._hints;
+        }
+        const durationMs = Date.now() - startTime;
+        // Log run finish
+        logger.log({
+            type: 'run_finished',
+            data: {
+                success: true,
+                durationMs,
+            },
+        });
+        return {
+            ...result,
+            runDir,
+            eventsPath,
+            artifactsDir,
+        };
+    }
+    catch (error) {
+        const durationMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Log error
+        logger.log({
+            type: 'error',
+            data: {
+                error: errorMessage,
+            },
+        });
+        // Save artifacts on error
+        if (page) {
+            try {
+                if (runContext) {
+                    await runContext.artifacts.saveScreenshot('error');
+                    const html = await page.content();
+                    await runContext.artifacts.saveHTML('error', html);
+                }
+                else {
+                    // Fallback: save artifacts directly if runContext wasn't created
+                    const screenshotPath = join(artifactsDir, 'error.png');
+                    await page.screenshot({ path: screenshotPath, fullPage: true });
+                    const html = await page.content();
+                    const htmlPath = join(artifactsDir, 'error.html');
+                    writeFileSync(htmlPath, html, 'utf-8');
+                }
+            }
+            catch (artifactError) {
+                // Ignore artifact save errors
+                console.error('Failed to save artifacts:', artifactError);
+            }
+        }
+        // Log run finish with failure
+        logger.log({
+            type: 'run_finished',
+            data: {
+                success: false,
+                durationMs,
+            },
+        });
+        // Return partial result with paths even on error
+        return {
+            collectibles: {},
+            meta: {
+                durationMs,
+                notes: `Error: ${errorMessage}`,
+            },
+            runDir,
+            eventsPath,
+            artifactsDir,
+        };
+    }
+    finally {
+        // Cleanup using unified browser session close
+        if (browserSession) {
+            await browserSession.close();
+        }
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,336 @@
+import type { Browser, Page } from 'playwright';
+import type { DslStep } from './dsl/types.js';
+import type { NetworkCaptureApi } from './networkCapture.js';
+/**
+ * Primitive types supported in input/collectible schemas
+ */
+export type PrimitiveType = 'string' | 'number' | 'boolean';
+/**
+ * Secret definition for task pack secrets
+ */
+export interface SecretDefinition {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/**
+ * Browser engine options
+ */
+export type BrowserEngine = 'chromium' | 'camoufox';
+/**
+ * Browser persistence mode
+ * - 'none': Ephemeral, no data persisted (default)
+ * - 'session': Data persisted in temp directory, cleared after 30min inactivity
+ * - 'profile': Data persisted in pack directory, permanent
+ */
+export type BrowserPersistence = 'none' | 'session' | 'profile';
+/**
+ * Browser configuration for task packs
+ */
+export interface BrowserSettings {
+    /**
+     * Browser engine to use (default: 'camoufox')
+     */
+    engine?: BrowserEngine;
+    /**
+     * Persistence mode for browser data (cookies, localStorage, etc.)
+     * - 'none': Fresh browser each run (default)
+     * - 'session': Persist in temp dir, cleared after inactivity
+     * - 'profile': Persist in pack's .browser-profile/ directory
+     */
+    persistence?: BrowserPersistence;
+}
+/**
+ * Field definition in a schema
+ */
+export interface FieldDefinition {
+    type: PrimitiveType;
+    required?: boolean;
+    description?: string;
+    /** Default value for this field when not provided */
+    default?: unknown;
+}
+/**
+ * Input schema definition
+ */
+export type InputSchema = Record<string, FieldDefinition>;
+/**
+ * Collectible definition
+ */
+export interface CollectibleDefinition {
+    name: string;
+    type: PrimitiveType;
+    description?: string;
+}
+/**
+ * Task Pack metadata
+ */
+export interface TaskPackMetadata {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+}
+/**
+ * Task Pack manifest (taskpack.json)
+ *
+ * Only json-dsl format is supported:
+ * - taskpack.json: metadata with kind: "json-dsl"
+ * - flow.json: inputs, collectibles, and flow steps
+ */
+export interface TaskPackManifest extends TaskPackMetadata {
+    /**
+     * Pack kind: must be "json-dsl"
+     */
+    kind: 'json-dsl';
+    /**
+     * Auth configuration for resilience and recovery
+     */
+    auth?: AuthConfig;
+    /**
+     * Secret definitions (names and descriptions for secrets stored in .secrets.json)
+     */
+    secrets?: SecretDefinition[];
+    /**
+     * Browser configuration
+     */
+    browser?: BrowserSettings;
+}
+/**
+ * Run context provided to task pack execution
+ */
+export interface RunContext {
+    page: Page;
+    browser: Browser;
+    logger: Logger;
+    artifacts: ArtifactManager;
+    /** Present when flow runs with network capture (e.g. runner); required for network_find/network_replay */
+    networkCapture?: NetworkCaptureApi;
+}
+/**
+ * Run result returned by task pack
+ */
+export interface RunResult {
+    collectibles: Record<string, unknown>;
+    meta: {
+        url?: string;
+        durationMs: number;
+        notes?: string;
+    };
+    /**
+     * Diagnostic hints from JSONPath operations (e.g., unsupported syntax, empty results).
+     * These help AI agents understand why data extraction may have failed.
+     */
+    _hints?: string[];
+}
+/**
+ * Logger interface for structured logging
+ */
+export interface Logger {
+    log(event: LogEvent): void;
+}
+/**
+ * Auth policy configuration for reactive auth failure detection and recovery
+ */
+export interface AuthPolicy {
+    /**
+     * Enable auth failure detection and recovery (default: true)
+     */
+    enabled?: boolean;
+    /**
+     * HTTP status codes that indicate auth failure (default: [401, 403])
+     */
+    statusCodes?: number[];
+    /**
+     * URL patterns (substring match) that trigger auth failure detection
+     * If provided, only responses matching these patterns will trigger recovery
+     */
+    urlIncludes?: string[];
+    /**
+     * URL regex patterns for auth failure detection
+     * If provided, only responses matching these patterns will trigger recovery
+     */
+    urlRegex?: string;
+    /**
+     * Optional: URL patterns that indicate login page (for navigation-based detection)
+     */
+    loginUrlIncludes?: string[];
+    /**
+     * Maximum number of recovery attempts per run (default: 1)
+     */
+    maxRecoveriesPerRun?: number;
+    /**
+     * Maximum number of times to retry a failed step after recovery (default: 1)
+     */
+    maxStepRetryAfterRecovery?: number;
+    /**
+     * Cooldown delay in milliseconds before retrying after recovery (default: 0)
+     */
+    cooldownMs?: number;
+}
+/**
+ * Auth guard configuration for proactive auth checks (OFF by default)
+ */
+export interface AuthGuard {
+    /**
+     * Enable auth guard (default: false)
+     */
+    enabled?: boolean;
+    /**
+     * Guard strategy: check for visible selector or URL pattern
+     */
+    strategy?: {
+        /**
+         * Assert that a selector is visible (preferred, no extra navigation)
+         */
+        visibleSelector?: string;
+        /**
+         * OR check URL pattern after initial navigation (if already on a page)
+         */
+        urlIncludes?: string;
+    };
+}
+/**
+ * Auth configuration for task packs
+ */
+export interface AuthConfig {
+    /**
+     * Auth policy for reactive failure detection and recovery
+     */
+    authPolicy?: AuthPolicy;
+    /**
+     * Auth guard for proactive checks (OFF by default)
+     */
+    authGuard?: AuthGuard;
+}
+/**
+ * Log event types
+ */
+export type LogEvent = {
+    type: 'run_started';
+    data: {
+        packId: string;
+        packVersion: string;
+        inputs: unknown;
+    };
+} | {
+    type: 'step_started';
+    data: {
+        stepId: string;
+        type: string;
+        label?: string;
+        params?: unknown;
+    };
+} | {
+    type: 'step_finished';
+    data: {
+        stepId: string;
+        type: string;
+        label?: string;
+        durationMs: number;
+    };
+} | {
+    type: 'step_skipped';
+    data: {
+        stepId: string;
+        type: string;
+        reason: 'once_already_executed' | 'condition_met';
+        restoredVars?: string[];
+        restoredCollectibles?: string[];
+        condition?: string;
+    };
+} | {
+    type: 'auth_failure_detected';
+    data: {
+        url: string;
+        status: number;
+        stepId?: string;
+    };
+} | {
+    type: 'auth_recovery_started';
+    data: {
+        recoveryAttempt: number;
+        maxRecoveries: number;
+    };
+} | {
+    type: 'auth_recovery_finished';
+    data: {
+        recoveryAttempt: number;
+        success: boolean;
+    };
+} | {
+    type: 'auth_recovery_exhausted';
+    data: {
+        url: string;
+        status: number;
+        maxRecoveries: number;
+    };
+} | {
+    type: 'run_finished';
+    data: {
+        success: boolean;
+        durationMs: number;
+    };
+} | {
+    type: 'error';
+    data: {
+        error: string;
+        stepId?: string;
+        type?: string;
+        label?: string;
+    };
+};
+/**
+ * Artifact manager for saving screenshots and HTML snapshots
+ */
+export interface ArtifactManager {
+    saveScreenshot(name: string): Promise<string>;
+    saveHTML(name: string, html: string): Promise<string>;
+}
+/**
+ * Task Pack module interface
+ *
+ * Supports two execution styles:
+ * - Declarative: provide `flow` array of DSL steps
+ * - Imperative: provide `run` function
+ *
+ * If both are provided, `flow` takes precedence.
+ */
+export interface TaskPack {
+    metadata: TaskPackMetadata;
+    inputs: InputSchema;
+    collectibles: CollectibleDefinition[];
+    /**
+     * Declarative flow of DSL steps
+     */
+    flow: DslStep[];
+    /**
+     * Auth configuration for resilience and recovery
+     */
+    auth?: AuthConfig;
+    /**
+     * Browser configuration
+     */
+    browser?: BrowserSettings;
+}
+/**
+ * A saved version snapshot of a flow
+ */
+export interface FlowVersion {
+    number: number;
+    /** Version string from taskpack.json metadata.version at snapshot time */
+    version: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    label?: string;
+    source: 'agent' | 'cli' | 'dashboard';
+    conversationId?: string;
+}
+/**
+ * Manifest tracking all saved versions for a pack
+ */
+export interface VersionManifest {
+    versions: FlowVersion[];
+    maxVersions: number;
+}
+//# 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 @@
+export {};

package/dist/validator.d.ts

@@ -0,0 +1,20 @@
+import type { InputSchema } from './types.js';
+/**
+ * Validates inputs against a schema
+ */
+export declare class InputValidator {
+    /**
+     * Apply default values from schema to inputs.
+     * Returns a new object with defaults applied for missing fields.
+     */
+    static applyDefaults(inputs: Record<string, unknown>, schema: InputSchema): Record<string, unknown>;
+    /**
+     * Validate inputs against schema
+     */
+    static validate(inputs: Record<string, unknown>, schema: InputSchema): void;
+    /**
+     * Validate a single value against a type
+     */
+    private static validateType;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,qBAAa,cAAc;IACzB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUnG;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IA6B3E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAoB5B"}

package/dist/validator.js

@@ -0,0 +1,68 @@
+/**
+ * Validates inputs against a schema
+ */
+export class InputValidator {
+    /**
+     * Apply default values from schema to inputs.
+     * Returns a new object with defaults applied for missing fields.
+     */
+    static applyDefaults(inputs, schema) {
+        const result = { ...inputs };
+        for (const [fieldName, fieldDef] of Object.entries(schema)) {
+            if (!(fieldName in result) && fieldDef.default !== undefined) {
+                result[fieldName] = fieldDef.default;
+            }
+        }
+        return result;
+    }
+    /**
+     * Validate inputs against schema
+     */
+    static validate(inputs, schema) {
+        const errors = [];
+        // Check required fields
+        for (const [fieldName, fieldDef] of Object.entries(schema)) {
+            if (fieldDef.required && !(fieldName in inputs)) {
+                errors.push(`Missing required field: ${fieldName}`);
+            }
+        }
+        // Check field types
+        for (const [fieldName, value] of Object.entries(inputs)) {
+            if (!(fieldName in schema)) {
+                errors.push(`Unknown field: ${fieldName}`);
+                continue;
+            }
+            const fieldDef = schema[fieldName];
+            const typeError = this.validateType(fieldName, value, fieldDef.type);
+            if (typeError) {
+                errors.push(typeError);
+            }
+        }
+        if (errors.length > 0) {
+            throw new Error(`Input validation failed:\n${errors.join('\n')}`);
+        }
+    }
+    /**
+     * Validate a single value against a type
+     */
+    static validateType(fieldName, value, expectedType) {
+        switch (expectedType) {
+            case 'string':
+                if (typeof value !== 'string') {
+                    return `Field ${fieldName} must be a string, got ${typeof value}`;
+                }
+                break;
+            case 'number':
+                if (typeof value !== 'number') {
+                    return `Field ${fieldName} must be a number, got ${typeof value}`;
+                }
+                break;
+            case 'boolean':
+                if (typeof value !== 'boolean') {
+                    return `Field ${fieldName} must be a boolean, got ${typeof value}`;
+                }
+                break;
+        }
+        return null;
+    }
+}