@showrun/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from './networkCapture.js';
+export * from './types.js';
+export * from './loader.js';
+export * from './validator.js';
+export * from './context.js';
+export * from './runner.js';
+export * from './jsonPackValidator.js';
+export * from './authResilience.js';
+export * from './browserLauncher.js';
+export * from './browserPersistence.js';
+export * from './packUtils.js';
+export * from './packVersioning.js';
+export * from './dsl/types.js';
+export * from './dsl/builders.js';
+export * from './dsl/interpreter.js';
+export * from './dsl/validation.js';
+export * from './dsl/templating.js';
+export * from './dsl/target.js';
+export * from './dsl/conditions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+export * from './networkCapture.js';
+export * from './types.js';
+export * from './loader.js';
+export * from './validator.js';
+export * from './context.js';
+export * from './runner.js';
+export * from './jsonPackValidator.js';
+export * from './authResilience.js';
+export * from './browserLauncher.js';
+export * from './browserPersistence.js';
+export * from './packUtils.js';
+export * from './packVersioning.js';
+// DSL exports
+export * from './dsl/types.js';
+export * from './dsl/builders.js';
+export * from './dsl/interpreter.js';
+export * from './dsl/validation.js';
+export * from './dsl/templating.js';
+export * from './dsl/target.js';
+export * from './dsl/conditions.js';

package/dist/jsonPackValidator.d.ts

@@ -0,0 +1,11 @@
+import type { TaskPack, CollectibleDefinition } from './types.js';
+import type { DslStep } from './dsl/types.js';
+/**
+ * Validates that collectibles referenced in flow steps exist
+ */
+export declare function validateCollectiblesMatchFlow(collectibles: CollectibleDefinition[], flow: DslStep[]): void;
+/**
+ * Validates a JSON Task Pack structure
+ */
+export declare function validateJsonTaskPack(pack: TaskPack): void;
+//# sourceMappingURL=jsonPackValidator.d.ts.map

package/dist/jsonPackValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonPackValidator.d.ts","sourceRoot":"","sources":["../src/jsonPackValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,qBAAqB,EAAE,EACrC,IAAI,EAAE,OAAO,EAAE,GACd,IAAI,CAsBN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAsCzD"}

package/dist/jsonPackValidator.js

@@ -0,0 +1,61 @@
+import { validateFlow, ValidationError } from './dsl/validation.js';
+/**
+ * Validates that collectibles referenced in flow steps exist
+ */
+export function validateCollectiblesMatchFlow(collectibles, flow) {
+    const collectibleNames = new Set(collectibles.map((c) => c.name));
+    const referencedOuts = new Set();
+    // Extract all 'out' parameters from extraction steps
+    for (const step of flow) {
+        if (step.type === 'extract_title' || step.type === 'extract_text' || step.type === 'extract_attribute') {
+            const out = step.params?.out;
+            if (out && typeof out === 'string') {
+                referencedOuts.add(out);
+            }
+        }
+    }
+    // Check that all referenced outs exist in collectibles
+    for (const out of referencedOuts) {
+        if (!collectibleNames.has(out)) {
+            throw new ValidationError(`Flow references collectible "${out}" in extraction step, but it's not defined in collectibles schema`);
+        }
+    }
+}
+/**
+ * Validates a JSON Task Pack structure
+ */
+export function validateJsonTaskPack(pack) {
+    const errors = [];
+    // Validate metadata
+    if (!pack.metadata.id || !pack.metadata.name || !pack.metadata.version) {
+        errors.push('Task pack must have metadata.id, metadata.name, and metadata.version');
+    }
+    // Validate inputs schema
+    if (!pack.inputs || typeof pack.inputs !== 'object') {
+        errors.push('Task pack must have an inputs object');
+    }
+    // Validate collectibles
+    if (!Array.isArray(pack.collectibles)) {
+        errors.push('Task pack must have a collectibles array');
+    }
+    // Validate flow
+    if (!pack.flow || !Array.isArray(pack.flow)) {
+        errors.push('Task pack must have a flow array');
+    }
+    else {
+        // Validate flow (includes step validation and duplicate ID check)
+        validateFlow(pack.flow, errors);
+        // Validate collectibles match flow
+        if (pack.collectibles && pack.flow) {
+            try {
+                validateCollectiblesMatchFlow(pack.collectibles, pack.flow);
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new ValidationError(`Task pack validation failed:\n${errors.join('\n')}`);
+    }
+}

package/dist/loader.d.ts

@@ -0,0 +1,35 @@
+import type { TaskPack, TaskPackManifest, SecretDefinition } from './types.js';
+/**
+ * Structure of the .secrets.json file
+ */
+export interface SecretsFile {
+    version: 1;
+    secrets: Record<string, string>;
+}
+/**
+ * Loads a Task Pack from a directory path
+ *
+ * Only json-dsl format is supported:
+ * - taskpack.json: metadata with kind: "json-dsl"
+ * - flow.json: inputs, collectibles, and flow steps
+ */
+export declare class TaskPackLoader {
+    /**
+     * Load task pack manifest from directory
+     */
+    static loadManifest(packPath: string): TaskPackManifest;
+    /**
+     * Load task pack from directory (json-dsl format only)
+     */
+    static loadTaskPack(packPath: string): Promise<TaskPack>;
+    /**
+     * Load secrets from .secrets.json file in pack directory
+     * Returns empty object if file doesn't exist
+     */
+    static loadSecrets(packPath: string): Record<string, string>;
+    /**
+     * Get secret definitions from manifest
+     */
+    static getSecretDefinitions(packPath: string): SecretDefinition[];
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAsC,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IA4BvD;;OAEG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwC9D;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAwB5D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;CAQlE"}

package/dist/loader.js

@@ -0,0 +1,107 @@
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+/**
+ * Loads a Task Pack from a directory path
+ *
+ * Only json-dsl format is supported:
+ * - taskpack.json: metadata with kind: "json-dsl"
+ * - flow.json: inputs, collectibles, and flow steps
+ */
+export class TaskPackLoader {
+    /**
+     * Load task pack manifest from directory
+     */
+    static loadManifest(packPath) {
+        const manifestPath = join(packPath, 'taskpack.json');
+        if (!existsSync(manifestPath)) {
+            throw new Error(`Task pack manifest not found: ${manifestPath}`);
+        }
+        let manifest;
+        try {
+            const content = readFileSync(manifestPath, 'utf-8');
+            manifest = JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse taskpack.json: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Validate required fields
+        if (!manifest.id || !manifest.name || !manifest.version) {
+            throw new Error('taskpack.json missing required fields: id, name, version');
+        }
+        // Only json-dsl format is supported
+        if (manifest.kind !== 'json-dsl') {
+            throw new Error('taskpack.json must have "kind": "json-dsl". Other formats are no longer supported.');
+        }
+        return manifest;
+    }
+    /**
+     * Load task pack from directory (json-dsl format only)
+     */
+    static async loadTaskPack(packPath) {
+        const manifest = this.loadManifest(packPath);
+        const flowPath = join(packPath, 'flow.json');
+        if (!existsSync(flowPath)) {
+            throw new Error(`flow.json not found for json-dsl pack: ${flowPath}`);
+        }
+        let flowData;
+        try {
+            const content = readFileSync(flowPath, 'utf-8');
+            flowData = JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse flow.json: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!flowData.flow || !Array.isArray(flowData.flow)) {
+            throw new Error('flow.json must have a "flow" array');
+        }
+        return {
+            metadata: {
+                id: manifest.id,
+                name: manifest.name,
+                version: manifest.version,
+                description: manifest.description,
+            },
+            inputs: flowData.inputs || {},
+            collectibles: flowData.collectibles || [],
+            flow: flowData.flow,
+            auth: manifest.auth,
+            browser: manifest.browser,
+        };
+    }
+    /**
+     * Load secrets from .secrets.json file in pack directory
+     * Returns empty object if file doesn't exist
+     */
+    static loadSecrets(packPath) {
+        const secretsPath = join(packPath, '.secrets.json');
+        if (!existsSync(secretsPath)) {
+            return {};
+        }
+        try {
+            const content = readFileSync(secretsPath, 'utf-8');
+            const secretsFile = JSON.parse(content);
+            // Validate version
+            if (secretsFile.version !== 1) {
+                console.warn(`[TaskPackLoader] Unsupported secrets file version: ${secretsFile.version}, expected 1`);
+                return {};
+            }
+            return secretsFile.secrets || {};
+        }
+        catch (error) {
+            console.warn(`[TaskPackLoader] Failed to load secrets from ${secretsPath}: ${error instanceof Error ? error.message : String(error)}`);
+            return {};
+        }
+    }
+    /**
+     * Get secret definitions from manifest
+     */
+    static getSecretDefinitions(packPath) {
+        try {
+            const manifest = this.loadManifest(packPath);
+            return manifest.secrets || [];
+        }
+        catch {
+            return [];
+        }
+    }
+}

package/dist/networkCapture.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Network capture for Playwright page sessions.
+ * Hooks request/response, maintains a rolling buffer with size limits.
+ * Full request headers kept in-memory for replay only; redacted everywhere else.
+ */
+import type { Page } from 'playwright';
+export interface NetworkEntryInternal {
+    id: string;
+    ts: number;
+    method: string;
+    url: string;
+    resourceType?: string;
+    requestHeaders: Record<string, string>;
+    /** Full request headers in-memory for replay only; never expose */
+    requestHeadersFull: Record<string, string>;
+    postData?: string;
+    status?: number;
+    responseHeaders?: Record<string, string>;
+    contentType?: string;
+    responseBodyText?: string;
+    responseBodyBase64?: string;
+    /** Approximate bytes used by this entry (for memory cap) */
+    bytesEstimate: number;
+}
+/** Redacted entry for list/get/API/MCP - no full headers, no large bodies */
+export interface NetworkEntrySummary {
+    id: string;
+    ts: number;
+    method: string;
+    url: string;
+    resourceType?: string;
+    requestHeaders: Record<string, string>;
+    postData?: string;
+    status?: number;
+    responseHeaders?: Record<string, string>;
+    contentType?: string;
+    /** First 2KB of response body if text; never full body in summary */
+    responseBodySnippet?: string;
+    responseBodyAvailable?: boolean;
+}
+export interface NetworkFindWhere {
+    urlIncludes?: string;
+    urlRegex?: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    status?: number;
+    contentTypeIncludes?: string;
+    /** Response body (text) must contain this string. Only entries with captured response body text are considered. */
+    responseContains?: string;
+}
+export interface NetworkReplayOverrides {
+    url?: string;
+    setQuery?: Record<string, string | number>;
+    setHeaders?: Record<string, string>;
+    body?: string;
+    /** Regex find/replace on the captured request URL (applied before overrides.url). Replace string can use $1, $2 for capture groups. */
+    urlReplace?: {
+        find: string;
+        replace: string;
+    };
+    /** Regex find/replace on the captured request body (applied before overrides.body). Replace string can use $1, $2 for capture groups. */
+    bodyReplace?: {
+        find: string;
+        replace: string;
+    };
+}
+/**
+ * Serializable network entry for caching (without Playwright-specific internals)
+ */
+export interface NetworkEntrySerializable {
+    id: string;
+    ts: number;
+    method: string;
+    url: string;
+    resourceType?: string;
+    requestHeaders: Record<string, string>;
+    requestHeadersFull: Record<string, string>;
+    postData?: string;
+    status?: number;
+    responseHeaders?: Record<string, string>;
+    contentType?: string;
+    responseBodyText?: string;
+    responseBodyBase64?: string;
+}
+export interface NetworkCaptureApi {
+    list(limit?: number, filter?: 'all' | 'api' | 'xhr'): NetworkEntrySummary[];
+    get(requestId: string): NetworkEntrySummary | null;
+    find(where: NetworkFindWhere, pick: 'first' | 'last'): NetworkEntrySummary | null;
+    replay(requestId: string, overrides?: NetworkReplayOverrides): Promise<{
+        status: number;
+        contentType?: string;
+        body: string;
+        bodySize: number;
+    }>;
+    clear(): void;
+    /** Get request ID from buffer by index (for find) */
+    getRequestIdByIndex(where: NetworkFindWhere, pick: 'first' | 'last'): string | null;
+    /** Export a network entry by ID for caching/serialization */
+    exportEntry(requestId: string): NetworkEntrySerializable | null;
+    /** Import a previously exported network entry into the buffer */
+    importEntry(entry: NetworkEntrySerializable): void;
+}
+/**
+ * Attach network capture to a Playwright page and return the capture API.
+ * Full request headers are kept in-memory only for replay; list/get return redacted summaries.
+ */
+export declare function attachNetworkCapture(page: Page): NetworkCaptureApi;
+//# sourceMappingURL=networkCapture.d.ts.map

package/dist/networkCapture.d.ts.map

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