@showrun/core 0.1.10 → 0.2.0-rc.1

package/dist/loader.js

@@ -29,17 +29,27 @@ export class TaskPackLoader {
         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.');
+        // Validate kind
+        const validKinds = ['json-dsl', 'playwright-js'];
+        if (!validKinds.includes(manifest.kind)) {
+            throw new Error(`taskpack.json "kind" must be one of: ${validKinds.join(', ')}. Got: "${manifest.kind}"`);
         }
         return manifest;
     }
     /**
-     * Load task pack from directory (json-dsl format only)
+     * Load task pack from directory
      */
     static async loadTaskPack(packPath) {
         const manifest = this.loadManifest(packPath);
+        if (manifest.kind === 'playwright-js') {
+            return this.loadPlaywrightJsPack(packPath, manifest);
+        }
+        return this.loadJsonDslPack(packPath, manifest);
+    }
+    /**
+     * Load a json-dsl task pack
+     */
+    static loadJsonDslPack(packPath, manifest) {
         const flowPath = join(packPath, 'flow.json');
         if (!existsSync(flowPath)) {
             throw new Error(`flow.json not found for json-dsl pack: ${flowPath}`);
@@ -72,6 +82,31 @@ export class TaskPackLoader {
             ...(snapshots ? { snapshots } : {}),
         };
     }
+    /**
+     * Load a playwright-js task pack
+     */
+    static loadPlaywrightJsPack(packPath, manifest) {
+        const flowPath = join(packPath, 'flow.playwright.js');
+        if (!existsSync(flowPath)) {
+            throw new Error(`flow.playwright.js not found for playwright-js pack: ${flowPath}`);
+        }
+        const source = readFileSync(flowPath, 'utf-8');
+        return {
+            metadata: {
+                id: manifest.id,
+                name: manifest.name,
+                version: manifest.version,
+                description: manifest.description,
+            },
+            kind: 'playwright-js',
+            inputs: manifest.inputs || {},
+            collectibles: manifest.collectibles || [],
+            flow: [], // Not used for playwright-js packs
+            playwrightJsSource: source,
+            auth: manifest.auth,
+            browser: manifest.browser,
+        };
+    }
     /**
      * Load secrets from .secrets.json file in pack directory
      * Returns empty object if file doesn't exist

package/dist/packUtils.d.ts

@@ -33,4 +33,8 @@ export declare function writeFlowJson(packDir: string, flowData: {
     collectibles?: CollectibleDefinition[];
     flow: DslStep[];
 }, skipValidation?: boolean): void;
+/**
+ * Write flow.playwright.js
+ */
+export declare function writePlaywrightJs(packDir: string, source: string): void;
 //# sourceMappingURL=packUtils.d.ts.map

package/dist/packUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packUtils.d.ts","sourceRoot":"","sources":["../src/packUtils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgBnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAUnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IACR,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB,EACD,cAAc,UAAQ,GACrB,IAAI,CAoBN"}
+{"version":3,"file":"packUtils.d.ts","sourceRoot":"","sources":["../src/packUtils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgBnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAUnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IACR,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB,EACD,cAAc,UAAQ,GACrB,IAAI,CAoBN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGvE"}

package/dist/packUtils.js

@@ -95,3 +95,10 @@ export function writeFlowJson(packDir, flowData, skipValidation = false) {
     const content = JSON.stringify(flowData, null, 2) + '\n';
     atomicWrite(flowPath, content);
 }
+/**
+ * Write flow.playwright.js
+ */
+export function writePlaywrightJs(packDir, source) {
+    const flowPath = join(packDir, 'flow.playwright.js');
+    atomicWrite(flowPath, source);
+}

package/dist/registry/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/registry/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAGhB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EAEX,iBAAiB,EACjB,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAC;AAMpB,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AAyCD,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,CAAC,EAAE,MAAM;IAQ1B,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAS/C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+C9D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAIpC,eAAe,IAAI,OAAO;IAOpB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IA4E1D,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAWxE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B1E,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAcvC,OAAO;IAwCrB;;;OAGG;YACW,mBAAmB;YAkCnB,kBAAkB;CAcjC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/registry/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAGhB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EAEX,iBAAiB,EACjB,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAC;AAsBpB,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AAyCD,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,CAAC,EAAE,MAAM;IAQ1B,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAS/C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+C9D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAIpC,eAAe,IAAI,OAAO;IAOpB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAiH1D,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAWxE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD1E,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAcvC,OAAO;IAwCrB;;;OAGG;YACW,mBAAmB;YAkCnB,kBAAkB;CAcjC"}

package/dist/registry/client.js

@@ -6,9 +6,24 @@
  * automatically refreshes access tokens before they expire.
  */
 import { join } from 'path';
+import { readFileSync } from 'fs';
 import { TaskPackLoader } from '../loader.js';
-import { readJsonFile, ensureDir, writeTaskPackManifest, writeFlowJson } from '../packUtils.js';
+import { readJsonFile, ensureDir, writeTaskPackManifest, writeFlowJson, writePlaywrightJs } from '../packUtils.js';
+import { SHOWRUN_VERSION } from '../version.js';
 import { loadTokens, saveTokens, clearTokens } from './tokenStore.js';
+function getCurrentShowrunVersion() {
+    return SHOWRUN_VERSION;
+}
+function withCurrentShowrunVersion(manifest) {
+    const currentVersion = getCurrentShowrunVersion();
+    const existingVersions = manifest.showrunVersions ?? [];
+    return {
+        ...manifest,
+        showrunVersions: existingVersions.includes(currentVersion)
+            ? existingVersions
+            : [...existingVersions, currentVersion],
+    };
+}
 // ── Error class ───────────────────────────────────────────────────────────
 export class RegistryError extends Error {
     status;
@@ -124,9 +139,24 @@ export class RegistryClient {
         const { packPath, slug: userSlug, visibility = 'public', changelog } = params;
         const warnings = [];
         // Load local pack
-        const manifest = TaskPackLoader.loadManifest(packPath);
-        const flowPath = join(packPath, 'flow.json');
-        const flowData = readJsonFile(flowPath);
+        const manifest = withCurrentShowrunVersion(TaskPackLoader.loadManifest(packPath));
+        writeTaskPackManifest(packPath, manifest);
+        // Load flow data based on pack kind
+        let flowData;
+        let playwrightJsSource;
+        if (manifest.kind === 'playwright-js') {
+            // playwright-js packs use flow.playwright.js (raw source code)
+            // The registry expects 'playwrightJsSource' at top level, not inside 'flow'
+            const flowPath = join(packPath, 'flow.playwright.js');
+            playwrightJsSource = readFileSync(flowPath, 'utf-8');
+            // For playwright-js, no flow object is needed
+            flowData = undefined;
+        }
+        else {
+            // json-dsl packs use flow.json
+            const flowPath = join(packPath, 'flow.json');
+            flowData = readJsonFile(flowPath);
+        }
         const slug = userSlug || manifest.id;
         // Try to get existing pack; create if 404.
         // Publish uses the short slug — server infers the @username scope from the
@@ -149,19 +179,38 @@ export class RegistryClient {
                 throw err;
             }
         }
-        // Publish version
-        const versionData = await this.request('POST', `/api/packs/${encodeURIComponent(slug)}/versions`, {
+        // Build the manifest payload for the registry
+        // For playwright-js packs, inputs and collectibles must be included in the manifest
+        // (the registry validates this)
+        const manifestPayload = {
+            id: manifest.id,
+            name: manifest.name,
             version: manifest.version,
-            manifest: {
-                id: manifest.id,
-                name: manifest.name,
-                version: manifest.version,
-                description: manifest.description,
-                kind: manifest.kind,
-            },
-            flow: flowData,
+            description: manifest.description,
+            kind: manifest.kind,
+            showrunVersions: manifest.showrunVersions,
+        };
+        // Include inputs and collectibles for playwright-js packs (required by registry)
+        if (manifest.kind === 'playwright-js') {
+            manifestPayload.inputs = manifest.inputs || {};
+            manifestPayload.collectibles = manifest.collectibles || [];
+        }
+        // Build the version request body
+        // For playwright-js, playwrightJsSource goes at top level
+        // For json-dsl, flow data goes under 'flow' key
+        const versionBody = {
+            version: manifest.version,
+            manifest: manifestPayload,
             changelog,
-        }, true);
+        };
+        if (manifest.kind === 'playwright-js') {
+            versionBody.playwrightJsSource = playwrightJsSource;
+        }
+        else {
+            versionBody.flow = flowData;
+        }
+        // Publish version
+        const versionData = await this.request('POST', `/api/packs/${encodeURIComponent(slug)}/versions`, versionBody, true);
         // The API may return version as a string or as an object with a nested version field
         const rawVersion = versionData.version;
         const version = typeof rawVersion === 'string'
@@ -203,6 +252,21 @@ export class RegistryClient {
         const packDir = join(destDir, ref);
         ensureDir(packDir);
         writeTaskPackManifest(packDir, versionData.manifest);
+        const currentVersion = getCurrentShowrunVersion();
+        const declaredVersions = versionData.manifest.showrunVersions ?? [];
+        if (declaredVersions.length > 0 && !declaredVersions.includes(currentVersion)) {
+            console.warn(`[ShowRun] Warning: installed pack ${ref}@${targetVersion} declares compatibility with ShowRun ${declaredVersions.join(', ')}, but current version is ${currentVersion}.`);
+        }
+        if (versionData.manifest.kind === 'playwright-js') {
+            if (!versionData.playwrightJsSource) {
+                throw new RegistryError(`Registry version payload for "${ref}" is missing playwrightJsSource`, 500, versionData);
+            }
+            writePlaywrightJs(packDir, versionData.playwrightJsSource);
+            return;
+        }
+        if (!versionData.flow) {
+            throw new RegistryError(`Registry version payload for "${ref}" is missing flow`, 500, versionData);
+        }
         writeFlowJson(packDir, versionData.flow);
     }
     // ── Reports ──────────────────────────────────────────────────────────

package/dist/runner.d.ts

@@ -1,5 +1,7 @@
+import { type Page } from 'playwright';
 import type { TaskPack, RunResult } from './types.js';
 import type { Logger } from './types.js';
+import type { NetworkCaptureApi } from './networkCapture.js';
 /**
  * Options for running a task pack
  */
@@ -45,6 +47,29 @@ export interface RunTaskPackOptions {
      * instead of launching a new one.
      */
     cdpUrl?: string;
+    /**
+     * Executor for playwright-js packs.
+     * If not provided, playwright-js packs will throw an error.
+     */
+    playwrightJsExecutor?: (source: string, scope: {
+        page: Page;
+        context: import('playwright').BrowserContext;
+        frame: import('playwright').Frame;
+        inputs: Record<string, unknown>;
+        secrets: Record<string, string>;
+        showrun: {
+            network: {
+                list: NetworkCaptureApi['list'];
+                find: NetworkCaptureApi['find'];
+                get: NetworkCaptureApi['get'];
+                replay: NetworkCaptureApi['replay'];
+            };
+        };
+        util: import('./util/index.js').PlaywrightJsUtil;
+    }, timeoutMs?: number) => Promise<{
+        collectibles: Record<string, unknown>;
+        logs: string[];
+    }>;
 }
 /**
  * Result of running a task pack with paths

package/dist/runner.d.ts.map

@@ -1 +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;AAczC;;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;IACjC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;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,CAqR5B"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAYzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;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;IACjC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QACL,IAAI,EAAE,IAAI,CAAC;QACX,OAAO,EAAE,OAAO,YAAY,EAAE,cAAc,CAAC;QAC7C,KAAK,EAAE,OAAO,YAAY,EAAE,KAAK,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,EAAE;YACP,OAAO,EAAE;gBACP,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBAChC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBAChC,GAAG,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;aACrC,CAAC;SACH,CAAC;QACF,IAAI,EAAE,OAAO,iBAAiB,EAAE,gBAAgB,CAAC;KAClD,EACD,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzE;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,CAiV5B"}

package/dist/runner.js

@@ -6,6 +6,7 @@ import { isFlowHttpCompatible } from './httpReplay.js';
 import { resolveProxy } from './proxy/proxyService.js';
 import { createReplayTransport } from './transport/index.js';
 import { writeSnapshots, extractTopLevelKeys, detectSensitiveHeaders, } from './requestSnapshot.js';
+import { createPlaywrightJsUtil } from './util/index.js';
 /**
  * Runs a task pack with Playwright
  * This is a reusable function that can be used by both CLI and MCP server
@@ -38,9 +39,11 @@ export async function runTaskPack(taskPack, inputs, options) {
     if (taskPack.browser?.proxy?.enabled && !resolvedProxy) {
         console.log('[runner] Proxy enabled in pack but credentials not configured, running without proxy');
     }
-    // ─── HTTP-first execution ───────────────────────────────────────────
+    // ─── playwright-js packs always need a browser ─────────────────────
+    const isPlaywrightJs = taskPack.kind === 'playwright-js';
+    // ─── HTTP-first execution (json-dsl only) ─────────────────────────
     const snapshots = taskPack.snapshots ?? null;
-    if (!options.skipHttpReplay && isFlowHttpCompatible(taskPack.flow, snapshots)) {
+    if (!isPlaywrightJs && !options.skipHttpReplay && isFlowHttpCompatible(taskPack.flow, snapshots)) {
         logger.log({
             type: 'run_started',
             data: {
@@ -67,7 +70,7 @@ export async function runTaskPack(taskPack, inputs, options) {
     let runContext = null;
     try {
         // Log run start (only if not already logged above)
-        if (options.skipHttpReplay || !isFlowHttpCompatible(taskPack.flow, snapshots)) {
+        if (isPlaywrightJs || options.skipHttpReplay || !isFlowHttpCompatible(taskPack.flow, snapshots)) {
             logger.log({
                 type: 'run_started',
                 data: {
@@ -103,44 +106,92 @@ export async function runTaskPack(taskPack, inputs, options) {
             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;
+        let result;
+        if (isPlaywrightJs) {
+            // ─── playwright-js execution ────────────────────────────────────
+            if (!taskPack.playwrightJsSource) {
+                throw new Error('playwright-js pack is missing playwrightJsSource');
+            }
+            if (!options.playwrightJsExecutor) {
+                throw new Error('playwright-js packs require a playwrightJsExecutor option');
+            }
+            const jsStartTime = Date.now();
+            const jsResult = await options.playwrightJsExecutor(taskPack.playwrightJsSource, {
+                page,
+                context: browserSession.context,
+                frame: page.mainFrame(),
+                inputs: inputsWithDefaults,
+                secrets,
+                showrun: {
+                    network: {
+                        list: networkCapture.list.bind(networkCapture),
+                        find: networkCapture.find.bind(networkCapture),
+                        get: networkCapture.get.bind(networkCapture),
+                        replay: networkCapture.replay.bind(networkCapture),
+                    },
+                },
+                util: createPlaywrightJsUtil(page),
+            });
+            const returnValue = jsResult.collectibles;
+            // Filter collectibles to only include those defined in the pack
+            const definedCollectibleNames = new Set((taskPack.collectibles || []).map(c => c.name));
+            const filteredCollectibles = {};
+            for (const [key, value] of Object.entries(returnValue)) {
+                if (definedCollectibleNames.has(key)) {
+                    filteredCollectibles[key] = value;
+                }
+            }
+            result = {
+                collectibles: filteredCollectibles,
+                meta: {
+                    url: page.url(),
+                    durationMs: Date.now() - jsStartTime,
+                    notes: 'Executed playwright-js flow',
+                },
+            };
+            // Surface captured console logs
+            if (jsResult.logs && jsResult.logs.length > 0) {
+                result._logs = jsResult.logs;
             }
         }
-        // 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;
-        }
-        // Capture snapshots for network_replay steps after successful browser run
-        if (packPath && networkCapture) {
-            try {
-                captureSnapshots(taskPack, flowResult, networkCapture, packPath);
+        else {
+            // ─── json-dsl execution ─────────────────────────────────────────
+            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
+            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;
+                }
+            }
+            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;
             }
-            catch (snapErr) {
-                console.warn(`[runner] Failed to capture snapshots: ${snapErr instanceof Error ? snapErr.message : String(snapErr)}`);
+            // Capture snapshots for network_replay steps after successful browser run
+            if (packPath && networkCapture) {
+                try {
+                    captureSnapshots(taskPack, flowResult, networkCapture, packPath);
+                }
+                catch (snapErr) {
+                    console.warn(`[runner] Failed to capture snapshots: ${snapErr instanceof Error ? snapErr.message : String(snapErr)}`);
+                }
             }
         }
         const durationMs = Date.now() - startTime;

package/dist/types.d.ts

@@ -84,6 +84,11 @@ export interface TaskPackMetadata {
     name: string;
     version: string;
     description?: string;
+    /**
+     * Execution timeout in milliseconds (default: 300000 = 5 minutes)
+     * Can be overridden by CLI --timeout flag
+     */
+    timeoutMs?: number;
 }
 /**
  * Task Pack manifest (taskpack.json)
@@ -94,9 +99,14 @@ export interface TaskPackMetadata {
  */
 export interface TaskPackManifest extends TaskPackMetadata {
     /**
-     * Pack kind: must be "json-dsl"
+     * ShowRun versions known to be compatible with this pack.
+     * Used by the registry to communicate runtime compatibility.
+     */
+    showrunVersions?: string[];
+    /**
+     * Pack kind
      */
-    kind: 'json-dsl';
+    kind: 'json-dsl' | 'playwright-js';
     /**
      * Auth configuration for resilience and recovery
      */
@@ -109,6 +119,14 @@ export interface TaskPackManifest extends TaskPackMetadata {
      * Browser configuration
      */
     browser?: BrowserSettings;
+    /**
+     * Input schema (used by playwright-js packs where inputs are declared in taskpack.json)
+     */
+    inputs?: InputSchema;
+    /**
+     * Collectible definitions (used by playwright-js packs where collectibles are declared in taskpack.json)
+     */
+    collectibles?: CollectibleDefinition[];
 }
 /**
  * Run context provided to task pack execution
@@ -136,6 +154,10 @@ export interface RunResult {
      * These help AI agents understand why data extraction may have failed.
      */
     _hints?: string[];
+    /**
+     * Captured console.log output from playwright-js flows.
+     */
+    _logs?: string[];
 }
 /**
  * Logger interface for structured logging
@@ -314,10 +336,18 @@ export interface TaskPack {
     metadata: TaskPackMetadata;
     inputs: InputSchema;
     collectibles: CollectibleDefinition[];
+    /**
+     * Pack kind (default: 'json-dsl')
+     */
+    kind?: 'json-dsl' | 'playwright-js';
     /**
      * Declarative flow of DSL steps
      */
     flow: DslStep[];
+    /**
+     * Raw Playwright JS source code (for playwright-js packs)
+     */
+    playwrightJsSource?: string;
     /**
      * Auth configuration for resilience and recovery
      */

package/dist/types.d.ts.map

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

package/dist/util/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Utility functions exposed to playwright-js flows via context.util
+ *
+ * These utilities help with common automation challenges like
+ * CAPTCHA solving, waiting for specific conditions, etc.
+ */
+import type { Page } from 'playwright';
+import { detectCloudflareTurnstile, solveCloudflareTurnstile, type TurnstileDetectionResult, type TurnstileSolveResult } from './turnstile.js';
+export { detectCloudflareTurnstile, solveCloudflareTurnstile };
+export type { TurnstileDetectionResult, TurnstileSolveResult };
+/**
+ * Utility object available in playwright-js flows as `util`
+ */
+export interface PlaywrightJsUtil {
+    /**
+     * Detect Cloudflare Turnstile checkbox position on the page.
+     *
+     * Uses image-based detection since Turnstile uses shadow-DOM
+     * which blocks direct element inspection.
+     *
+     * @example
+     * ```javascript
+     * const result = await util.detectCloudflareTurnstile();
+     * if (result.found) {
+     *   console.log(`Turnstile at (${result.x}, ${result.y})`);
+     * }
+     * ```
+     */
+    detectCloudflareTurnstile: (options?: {
+        scale?: number;
+    }) => Promise<TurnstileDetectionResult>;
+    /**
+     * Detect and solve Cloudflare Turnstile by clicking the checkbox.
+     *
+     * This function detects the widget, clicks the checkbox, and waits
+     * for verification. Automatically retries if detection fails.
+     *
+     * @example
+     * ```javascript
+     * const result = await util.solveCloudflareTurnstile();
+     * if (result.success) {
+     *   console.log('Turnstile solved!');
+     * } else {
+     *   console.log('Failed:', result.error);
+     * }
+     * ```
+     */
+    solveCloudflareTurnstile: (options?: {
+        /** Scale factor for HiDPI displays (default: 1) */
+        scale?: number;
+        /** Time to wait after clicking (default: 2000ms) */
+        waitAfterClick?: number;
+        /** Number of retry attempts (default: 3) */
+        retries?: number;
+        /** Delay between retries (default: 1000ms) */
+        retryDelay?: number;
+    }) => Promise<TurnstileSolveResult>;
+}
+/**
+ * Create the util object for a playwright-js execution context.
+ *
+ * @param page - Playwright Page object to bind utilities to
+ * @returns Utility object with bound methods
+ */
+export declare function createPlaywrightJsUtil(page: Page): PlaywrightJsUtil;
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;OAaG;IACH,yBAAyB,EAAE,CAAC,OAAO,CAAC,EAAE;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;OAeG;IACH,wBAAwB,EAAE,CAAC,OAAO,CAAC,EAAE;QACnC,mDAAmD;QACnD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,oDAAoD;QACpD,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,4CAA4C;QAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,8CAA8C;QAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAKnE"}

package/dist/util/index.js

@@ -0,0 +1,21 @@
+/**
+ * Utility functions exposed to playwright-js flows via context.util
+ *
+ * These utilities help with common automation challenges like
+ * CAPTCHA solving, waiting for specific conditions, etc.
+ */
+import { detectCloudflareTurnstile, solveCloudflareTurnstile, } from './turnstile.js';
+// Re-export for direct usage
+export { detectCloudflareTurnstile, solveCloudflareTurnstile };
+/**
+ * Create the util object for a playwright-js execution context.
+ *
+ * @param page - Playwright Page object to bind utilities to
+ * @returns Utility object with bound methods
+ */
+export function createPlaywrightJsUtil(page) {
+    return {
+        detectCloudflareTurnstile: (options) => detectCloudflareTurnstile(page, options),
+        solveCloudflareTurnstile: (options) => solveCloudflareTurnstile(page, options),
+    };
+}