devharness 0.9.14 → 0.9.16

package/build/tools/replay-run-all-parity.test.js

@@ -0,0 +1,90 @@
+/**
+ * `runAll` fans `run` out over a folder, so a per-run option either carries or
+ * is deliberately withheld. Two carry that a suite needs:
+ *
+ *  - `baseUrl` retargets every sequence at the same deployment. A suite that
+ *    could only run against the recorded origin is a suite that can only test
+ *    the machine it was recorded on.
+ *  - `killChromeOnFinish` means the SUITE's finish, so only the last sequence
+ *    carries it: passing it to each one tears down the browser between
+ *    sequences and destroys the state a _helpers preamble established.
+ *
+ * The rest (startFrom/stepTo/stepCount/startUrl) address one specific
+ * sequence and are cleared.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { promises as fs } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { CommandRecorder } from '../command-recorder.js';
+import { createReplayTools } from './replay-tools.js';
+import { productionShaped } from '../test-support/fake-execute-tool-call.js';
+let dir;
+let recorder;
+let replay;
+let gotoUrls;
+let killCalls;
+const writeSequence = async (name, url) => {
+    await fs.writeFile(join(dir, `${name}.json`), JSON.stringify({
+        id: `seq-${name}`, name, createdAt: 1,
+        commands: [{ tool: 'navigate', params: { action: 'goto', url, connectionReason: 'suite' } }],
+    }));
+};
+beforeEach(async () => {
+    dir = await fs.mkdtemp(join(tmpdir(), 'cdp-runall-parity-'));
+    recorder = new CommandRecorder();
+    gotoUrls = [];
+    killCalls = 0;
+    vi.spyOn(recorder, 'getSequencesDir').mockReturnValue(dir);
+    ({ replay } = createReplayTools(recorder, vi.fn(productionShaped(async (tool, params) => {
+        if (tool === 'navigate' && params.action === 'goto')
+            gotoUrls.push(String(params.url));
+        if (tool === 'killChrome')
+            killCalls++;
+        return { content: [{ type: 'text', text: '' }] };
+    })), async () => null, // no page -> no cursor/overlay injection
+    async () => 9222, undefined));
+});
+afterEach(async () => {
+    recorder.stopSequenceWatch();
+    await fs.rm(dir, { recursive: true, force: true });
+});
+const runAll = (params = {}) => replay.handler({ action: 'runAll', ...params });
+describe('runAll carries baseUrl', () => {
+    it('retargets every sequence in the suite', async () => {
+        await writeSequence('a-first', 'https://staging.example.com/one');
+        await writeSequence('b-second', 'https://staging.example.com/two?q=1');
+        await runAll({ baseUrl: 'https://cue-test.pages.dev', connectionReason: 'suite' });
+        expect(gotoUrls).toEqual([
+            'https://cue-test.pages.dev/one',
+            'https://cue-test.pages.dev/two?q=1',
+        ]);
+    });
+    it('leaves the recorded origin in place when no baseUrl is given', async () => {
+        await writeSequence('a-first', 'https://staging.example.com/one');
+        await runAll({ connectionReason: 'suite' });
+        expect(gotoUrls).toEqual(['https://staging.example.com/one']);
+    });
+    it('does not write the retarget back to the sequence file', async () => {
+        await writeSequence('a-first', 'https://staging.example.com/one');
+        await runAll({ baseUrl: 'https://cue-test.pages.dev', connectionReason: 'suite' });
+        const onDisk = JSON.parse(await fs.readFile(join(dir, 'a-first.json'), 'utf-8'));
+        expect(onDisk.commands[0].params.url).toBe('https://staging.example.com/one');
+    });
+});
+describe('runAll carries killChromeOnFinish once', () => {
+    it('kills after the last sequence, not between them', async () => {
+        await writeSequence('a-first', 'https://staging.example.com/one');
+        await writeSequence('b-second', 'https://staging.example.com/two');
+        await runAll({ killChromeOnFinish: true, connectionReason: 'suite' });
+        expect(gotoUrls.length).toBe(2);
+        expect(killCalls).toBe(1);
+    });
+    it('kills nothing when it is not asked for', async () => {
+        await writeSequence('a-first', 'https://staging.example.com/one');
+        await writeSequence('b-second', 'https://staging.example.com/two');
+        await runAll({ connectionReason: 'suite' });
+        expect(killCalls).toBe(0);
+    });
+});
+//# sourceMappingURL=replay-run-all-parity.test.js.map

package/build/tools/replay-run-all-parity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-run-all-parity.test.js","sourceRoot":"","sources":["../../src/tools/replay-run-all-parity.test.ts"],"names":[],"mappings":"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"}

package/build/tools/replay-tools.d.ts

@@ -115,6 +115,13 @@ getKnownToolNames?: () => string[]): {
             connectionReason?: string | undefined;
             stepTimeout?: number | undefined;
             totalTimeout?: number | undefined;
+            requiredConnections?: {
+                reference: string;
+                profile?: string | undefined;
+                url?: string | undefined;
+                forceNewInstance?: boolean | undefined;
+                role?: string | undefined;
+            }[] | undefined;
             limit?: number | undefined;
             comment?: string | undefined;
             stepTo?: number | undefined;
@@ -131,13 +138,6 @@ getKnownToolNames?: () => string[]): {
             runId?: string | undefined;
             format?: "sequence" | "playwright" | "puppeteer" | undefined;
             intoHistory?: boolean | undefined;
-            requiredConnections?: {
-                reference: string;
-                profile?: string | undefined;
-                url?: string | undefined;
-                forceNewInstance?: boolean | undefined;
-                role?: string | undefined;
-            }[] | undefined;
             tags?: string[] | undefined;
             requiredSockets?: string[] | undefined;
             connections?: Record<string, string> | undefined;
@@ -173,6 +173,13 @@ getKnownToolNames?: () => string[]): {
             connectionReason?: string | undefined;
             stepTimeout?: number | undefined;
             totalTimeout?: number | undefined;
+            requiredConnections?: {
+                reference: string;
+                profile?: string | undefined;
+                url?: string | undefined;
+                forceNewInstance?: boolean | undefined;
+                role?: string | undefined;
+            }[] | undefined;
             limit?: number | undefined;
             comment?: string | undefined;
             stepTo?: number | undefined;
@@ -189,13 +196,6 @@ getKnownToolNames?: () => string[]): {
             runId?: string | undefined;
             format?: "sequence" | "playwright" | "puppeteer" | undefined;
             intoHistory?: boolean | undefined;
-            requiredConnections?: {
-                reference: string;
-                profile?: string | undefined;
-                url?: string | undefined;
-                forceNewInstance?: boolean | undefined;
-                role?: string | undefined;
-            }[] | undefined;
             tags?: string[] | undefined;
             requiredSockets?: string[] | undefined;
             connections?: Record<string, string> | undefined;
@@ -238,6 +238,13 @@ getKnownToolNames?: () => string[]): {
             connectionReason?: string | undefined;
             stepTimeout?: number | undefined;
             totalTimeout?: number | undefined;
+            requiredConnections?: {
+                reference: string;
+                profile?: string | undefined;
+                url?: string | undefined;
+                forceNewInstance?: boolean | undefined;
+                role?: string | undefined;
+            }[] | undefined;
             limit?: number | undefined;
             comment?: string | undefined;
             stepTo?: number | undefined;
@@ -254,13 +261,6 @@ getKnownToolNames?: () => string[]): {
             runId?: string | undefined;
             format?: "sequence" | "playwright" | "puppeteer" | undefined;
             intoHistory?: boolean | undefined;
-            requiredConnections?: {
-                reference: string;
-                profile?: string | undefined;
-                url?: string | undefined;
-                forceNewInstance?: boolean | undefined;
-                role?: string | undefined;
-            }[] | undefined;
             tags?: string[] | undefined;
             requiredSockets?: string[] | undefined;
             connections?: Record<string, string> | undefined;

package/build/tools/replay-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay-tools.d.ts","sourceRoot":"","sources":["../../src/tools/replay-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,eAAe,EAAyD,MAAM,wBAAwB,CAAC;AACrH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgFnD,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACnC,cAAc,EAAE,MAAM,EAAE,GACvB,eAAe,EAAE,CAWnB;AAmwGD,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,eAAe,EAChC,oBAAoB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EACjE,iBAAiB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;AACxE;;;;;GAKG;AACH,iBAAiB,CAAC,EAAE,MAAM,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDnC"}
+{"version":3,"file":"replay-tools.d.ts","sourceRoot":"","sources":["../../src/tools/replay-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,eAAe,EAAyD,MAAM,wBAAwB,CAAC;AACrH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgFnD,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACnC,cAAc,EAAE,MAAM,EAAE,GACvB,eAAe,EAAE,CAWnB;AA4wGD,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,eAAe,EAChC,oBAAoB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EACjE,iBAAiB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;AACxE;;;;;GAKG;AACH,iBAAiB,CAAC,EAAE,MAAM,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDnC"}

package/build/tools/replay-tools.js

@@ -133,7 +133,7 @@ const replaySchema = z.object({
     description: z.string().optional(),
     expectedOutcome: z.string().optional(),
     startUrl: z.string().optional().describe('create: sequence start URL. run: replace the stored startUrl for this run only (e.g. a freshly minted link)'),
-    baseUrl: z.string().optional().describe('run: retarget the sequence at another deployment — every absolute URL (startUrl + command params) keeps its path/query but takes this origin. Not preserved across a mid-run pause/step resume'),
+    baseUrl: z.string().optional().describe('run/runAll: retarget at another deployment — every absolute URL (startUrl, command params, a declared connection\u2019s launch url) keeps its path/query but takes this origin, in the sequence itself and in every sequence it reaches through a conditional or forEach. On runAll it applies to every sequence in the suite. Not preserved across a mid-run pause/step resume'),
     indices: z.array(z.number()).optional().describe('Command indices'),
     lines: z.array(z.number()).optional().describe('Log line numbers'),
     sequenceId: z.string().optional(),
@@ -184,7 +184,7 @@ const replaySchema = z.object({
     strict: z.enum(['errors', 'warnings']).optional().describe("run/runAll: fail the run when it PRODUCES console output - 'errors' fails on new console errors, 'warnings' also fails on new warnings. Counted per connection and diffed against the start of the run, so pre-existing noise is not blamed on this sequence. A sequence can be functionally correct and still be logging; strict is how you separate those questions"),
     folder: z.string().optional().describe("runAll: sequences subfolder to run, relative to the sequences dir (e.g. 'spine'). Omit to run every sequence outside folders whose name starts with '_'. The whole tree is always LOADED first so name references (a conditional's then, a forEach's do) resolve wherever the helper lives"),
     continueOnFailure: z.boolean().optional().describe('runAll: keep going after a sequence fails and report every result (default true). false stops at the first failure'),
-    killChromeOnFinish: z.boolean().optional().describe("run: after finishing (skipped on pause/abort), kill the browsers this run owns - its own connection plus any a launchChrome step actually created. A step that reached an already-bound reference only borrowed that browser and it is left running, so an instance you launched yourself survives. Also skipped for any browser whose port another live connection shares (a launchChrome step usually opens a tab in the same instance), and the run reports which connection kept it alive."),
+    killChromeOnFinish: z.boolean().optional().describe("run/runAll: after finishing (skipped on pause/abort), kill the browsers this run owns - its own connection plus any a launchChrome step actually created. A step that reached an already-bound reference only borrowed that browser and it is left running, so an instance you launched yourself survives. Also skipped for any browser whose port another live connection shares (a launchChrome step usually opens a tab in the same instance), and the run reports which connection kept it alive. On runAll only the LAST sequence carries it, so a preamble's browser survives between sequences and a suite that stops early leaves the browsers up."),
 }).strict();
 async function handleHistory(args, recorder) {
     const limit = args.limit || 50;
@@ -840,7 +840,13 @@ async function handleRunAll(args, recorder, executeToolCall, getPageForConnectio
     }
     const keepGoing = args.continueOnFailure !== false;
     const results = [];
-    for (const entry of selected) {
+    for (const [index, entry] of selected.entries()) {
+        // killChromeOnFinish means the SUITE's finish here, not each sequence's: a
+        // teardown between sequences destroys the state a _helpers preamble just
+        // established. Only the last sequence carries it, so a suite that stops
+        // early (continueOnFailure: false, a cancel) leaves the browsers up for
+        // the failure to be read in.
+        const isLast = index === selected.length - 1;
         if (abortSignal?.aborted) {
             results.push({ filename: entry.filename, name: entry.name, ok: false, detail: 'cancelled before it ran' });
             continue;
@@ -863,11 +869,11 @@ async function handleRunAll(args, recorder, executeToolCall, getPageForConnectio
                 // no-op that a caller then has to notice.
                 variables: args.variables ?? {},
                 // Per-run args that are actively wrong when fanned across a suite:
-                // killChromeOnFinish would tear down the browser between sequences and
-                // destroy the state a _helpers preamble just established, and
                 // startFrom/stepTo/stepCount/startUrl mean something only for one
-                // specific sequence.
-                killChromeOnFinish: undefined,
+                // specific sequence. baseUrl does carry - it retargets every
+                // sequence at the same deployment, which is what a suite run of a
+                // recorded set against another environment needs.
+                killChromeOnFinish: isLast ? args.killChromeOnFinish : undefined,
                 startFrom: undefined,
                 stepTo: undefined,
                 stepCount: undefined,
@@ -1618,7 +1624,10 @@ async function performRun(deps, abortSignal, runId, onProgress) {
         logPrefix: 'run',
         variableStore: {},
         launchedConnections,
-        ...(connectionMap && { connectionMap })
+        ...(connectionMap && { connectionMap }),
+        // Carried on the context so nested sequences inherit the retarget; the
+        // top-level sequence was already rebased in handleRun.
+        ...(args.baseUrl && { rebaseOrigin: args.baseUrl })
     };
     // Ensure connection is ready
     let didAutoLaunch = false;