devharness 0.8.0

package/build/tools/replay-output-and-record-options.test.js

@@ -0,0 +1,240 @@
+/**
+ * Coverage for two dead-parameter bugs in the `replay` tool (issue #97):
+ *
+ * A) recordInteraction accepted simplifyEvents/includeHovers/preferCoordinates/
+ *    preferSelectors but hardcoded them when calling eventsToCommands.
+ * B) outputFormat advertised six values but only playwright/puppeteer did
+ *    anything; the rest silently fell through to the default detail view.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { productionShaped } from '../test-support/fake-execute-tool-call.js';
+const startRecordingMock = vi.fn();
+const eventsToCommandsSpy = vi.fn();
+vi.mock('../interaction-recorder.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        startRecording: (...args) => startRecordingMock(...args),
+        eventsToCommands: (...args) => {
+            eventsToCommandsSpy(...args);
+            return actual.eventsToCommands(...args);
+        },
+    };
+});
+// Keep the issue tracker off the filesystem.
+vi.mock('../issue-tracker.js', () => ({
+    addIssue: vi.fn(),
+    initializeTracker: vi.fn(async () => undefined),
+    saveIssueSequence: vi.fn(async () => undefined),
+    getIssue: vi.fn(async () => null),
+    updateIssue: vi.fn(async () => undefined),
+    getIssues: vi.fn(async () => []),
+}));
+const { createReplayTools } = await import('./replay-tools.js');
+const { CommandRecorder } = await import('../command-recorder.js');
+function makeTool(recorder) {
+    // A real tool always returns at least one content item; `{ content: [] }`
+    // made every `content[0].text` read undefined.
+    const executeToolCall = vi.fn(productionShaped(async (..._args) => ({ content: [{ type: 'text', text: '' }] })));
+    const getPageForConnection = vi.fn(async () => ({ /* fake CDP page */}));
+    return createReplayTools(recorder, executeToolCall, getPageForConnection).replay;
+}
+const recordingEvents = [
+    { type: 'click', timestamp: 1000, x: 10, y: 20, elementInfo: { selector: '#go' } },
+    { type: 'mousemove', timestamp: 1100, x: 30, y: 40 },
+    { type: 'mousemove', timestamp: 1200, x: 50, y: 60 },
+    { type: 'click', timestamp: 1300, x: 70, y: 80, elementInfo: { selector: '#done' } },
+];
+beforeEach(() => {
+    startRecordingMock.mockReset();
+    eventsToCommandsSpy.mockReset();
+    startRecordingMock.mockResolvedValue({
+        success: true,
+        recording: {
+            events: recordingEvents,
+            startUrl: 'http://localhost:3000/',
+            duration: 2000,
+            summary: { clicks: 2, drags: 0, scrolls: 0, keyPresses: 0, navigations: 0, comments: 0 },
+        },
+    });
+});
+async function record(extraArgs = {}) {
+    const recorder = new CommandRecorder();
+    const tool = makeTool(recorder);
+    const result = await tool.handler({
+        action: 'recordInteraction',
+        connectionReason: `rec-${Math.random().toString(36).slice(2)}`,
+        ...extraArgs,
+    });
+    return { result, recorder, options: eventsToCommandsSpy.mock.calls[0]?.[1] };
+}
+describe('recordInteraction threads recording options into eventsToCommands (bug A)', () => {
+    it('keeps the previous hardcoded values as defaults', async () => {
+        const { options } = await record();
+        expect(options).toMatchObject({
+            simplify: true,
+            includeDelays: true,
+            includeHovers: false,
+            preferCoordinates: false,
+            preferSelectors: false,
+        });
+    });
+    it('passes simplifyEvents through as `simplify`', async () => {
+        const { options } = await record({ simplifyEvents: false });
+        expect(options.simplify).toBe(false);
+    });
+    it('passes includeHovers through, and hover commands actually appear', async () => {
+        const { options, recorder } = await record({ includeHovers: true });
+        expect(options.includeHovers).toBe(true);
+        const seq = recorder.listSequences()[0];
+        expect(seq.commands.some(c => c.params.action === 'mousemove')).toBe(true);
+    });
+    it('passes preferCoordinates through, producing x/y clicks instead of selectors', async () => {
+        const { options, recorder } = await record({ preferCoordinates: true });
+        expect(options.preferCoordinates).toBe(true);
+        const clicks = recorder.listSequences()[0].commands.filter(c => c.params.action === 'click');
+        expect(clicks.length).toBeGreaterThan(0);
+        expect(clicks.every(c => typeof c.params.x === 'number' && c.params.selector === undefined)).toBe(true);
+    });
+    it('preferSelectors wins when both preference flags are set', async () => {
+        const { options, recorder } = await record({ preferCoordinates: true, preferSelectors: true });
+        expect(options).toMatchObject({ preferCoordinates: true, preferSelectors: true });
+        const clicks = recorder.listSequences()[0].commands.filter(c => c.params.action === 'click');
+        expect(clicks.every(c => c.params.selector !== undefined)).toBe(true);
+    });
+});
+describe('replay schema no longer accepts dead parameters', () => {
+    const parse = async (args) => {
+        const recorder = new CommandRecorder();
+        const tool = makeTool(recorder);
+        return tool.zodSchema.safeParse({ action: 'get', name: 'x', ...args });
+    };
+    it('rejects recordingId (nothing ever read it)', async () => {
+        expect((await parse({ recordingId: 3 })).success).toBe(false);
+    });
+    it('rejects outputFormat values with no implementation', async () => {
+        expect((await parse({ outputFormat: 'csv' })).success).toBe(false);
+    });
+    it("accepts outputFormat 'review' now that recordInteraction implements it", async () => {
+        expect((await parse({ outputFormat: 'review' })).success).toBe(true);
+    });
+});
+describe('outputFormat produces distinguishable output for every surviving value (bug B)', () => {
+    const sequence = {
+        id: 'seq-1',
+        name: 'fmt-test',
+        commands: [
+            { tool: 'navigate', params: { action: 'goto', url: 'http://localhost:3000/' } },
+            { tool: 'input', params: { action: 'click', selector: '#go' }, delay: 250 },
+            { tool: 'input', params: { action: 'type', text: 'hello' } },
+        ],
+        createdAt: Date.now(),
+        startUrl: 'http://localhost:3000/',
+    };
+    async function get(outputFormat) {
+        const recorder = new CommandRecorder();
+        recorder.sequences.set(sequence.id, sequence);
+        const tool = makeTool(recorder);
+        const res = await tool.handler({ action: 'get', name: sequence.name, outputFormat });
+        return res.content[0].text;
+    }
+    it('default returns the human detail view', async () => {
+        const text = await get();
+        expect(text).toContain('**Commands**');
+    });
+    it('commands returns machine-readable JSON of the command list', async () => {
+        const text = await get('commands');
+        const json = JSON.parse(text.slice(text.indexOf('['), text.lastIndexOf(']') + 1));
+        expect(json).toHaveLength(3);
+        expect(json[1]).toMatchObject({ tool: 'input', params: { action: 'click', selector: '#go' }, delay: 250 });
+        expect(text).not.toContain('await page');
+    });
+    it('events is rejected with an explicit error - a stored sequence has no raw events', async () => {
+        const text = await get('events');
+        expect(text).toContain('recordInteraction');
+        expect(text).toContain('commands');
+        expect(text).not.toContain('**Commands**');
+    });
+    it('playwright and puppeteer return distinct generated code', async () => {
+        const pw = await get('playwright');
+        const pp = await get('puppeteer');
+        expect(pw).toContain('@playwright/test');
+        expect(pp).toContain("require('puppeteer')");
+        expect(pw).not.toBe(pp);
+    });
+    it('review is rejected with its own explicit error - it renders raw events too', async () => {
+        const text = await get('review');
+        expect(text).toContain('review');
+        expect(text).toContain('recordInteraction');
+        expect(text).not.toContain('**Commands**');
+    });
+    it('every surviving outputFormat value yields a unique response', async () => {
+        const outputs = await Promise.all([undefined, 'events', 'commands', 'review', 'playwright', 'puppeteer'].map(f => get(f)));
+        expect(new Set(outputs).size).toBe(outputs.length);
+    });
+});
+describe('recordInteraction honours outputFormat (bug B, raw-event side)', () => {
+    it("outputFormat 'events' appends the raw recorded events as JSON", async () => {
+        const { result } = await record({ outputFormat: 'events' });
+        const text = result.content[0].text;
+        expect(text).toContain('Raw recorded events');
+        const json = JSON.parse(text.slice(text.indexOf('['), text.lastIndexOf(']') + 1));
+        expect(json).toHaveLength(recordingEvents.length);
+        expect(json[0]).toMatchObject({ type: 'click', x: 10, y: 20 });
+    });
+    it("outputFormat 'commands' appends the converted commands as JSON", async () => {
+        const { result } = await record({ outputFormat: 'commands' });
+        const text = result.content[0].text;
+        expect(text).toContain('Commands (JSON)');
+        const json = JSON.parse(text.slice(text.indexOf('['), text.lastIndexOf(']') + 1));
+        expect(json[0]).toMatchObject({ tool: 'input', params: { action: 'click', selector: '#go' } });
+    });
+    it("outputFormat 'review' appends a human-readable walkthrough, not JSON", async () => {
+        const { result } = await record({ outputFormat: 'review' });
+        const text = result.content[0].text;
+        expect(text).toContain('Event Review');
+        // Markdown walkthrough, not a JSON dump of either events or commands.
+        expect(text).toContain('### 1. CLICK at (10, 20)');
+        expect(text).toContain('Selector: `#go`');
+        expect(text).not.toContain('Raw recorded events');
+        expect(text).not.toContain('Commands (JSON)');
+        expect(text).not.toContain('"timestamp"');
+        // mousemove noise is dropped from the review
+        expect(text).not.toContain('MOUSEMOVE');
+    });
+    it("outputFormat 'review' renders the wider event variants instead of dropping them", async () => {
+        startRecordingMock.mockResolvedValue({
+            success: true,
+            recording: {
+                events: [
+                    { type: 'navigation', timestamp: 1000, url: 'http://localhost:3000/next', previousUrl: 'http://localhost:3000/' },
+                    { type: 'click', timestamp: 1100, x: 10, y: 20, elementInfo: { tag: 'button', selector: '#go', isInteractive: true } },
+                    { type: 'paste', timestamp: 1200, text: 'pasted-value', targetInfo: { tag: 'input', id: 'email', isInput: true } },
+                    { type: 'comment', timestamp: 1300, text: 'this is where it goes wrong', category: 'narrative' },
+                ],
+                startUrl: 'http://localhost:3000/',
+                duration: 2000,
+                summary: { clicks: 1, drags: 0, scrolls: 0, keyPresses: 0, navigations: 1, comments: 1 },
+            },
+        });
+        const { result } = await record({ outputFormat: 'review' });
+        const text = result.content[0].text;
+        const review = text.slice(text.indexOf('**Event Review'));
+        expect(review).toContain('NAVIGATION to http://localhost:3000/next');
+        expect(review).toContain('From: http://localhost:3000/');
+        expect(review).toContain('PASTE');
+        expect(review).toContain('"pasted-value"');
+        expect(review).toContain('Target: `input#email`');
+        expect(review).toContain('COMMENT');
+        expect(review).toContain('this is where it goes wrong');
+        // All four events are numbered - nothing fell through silently.
+        expect(review).toContain('### 4.');
+    });
+    it('appends nothing when outputFormat is omitted', async () => {
+        const { result } = await record();
+        const text = result.content[0].text;
+        expect(text).not.toContain('Raw recorded events');
+        expect(text).not.toContain('Commands (JSON)');
+    });
+});
+//# sourceMappingURL=replay-output-and-record-options.test.js.map

package/build/tools/replay-output-and-record-options.test.js.map

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

package/build/tools/replay-production-error-shape.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Branches that were dead in production because they read `result.isError`,
+ * while the live executeToolCall raises the same failure as a ToolError. Each
+ * test drives the THROWN shape - the one that actually happens.
+ */
+export {};
+//# sourceMappingURL=replay-production-error-shape.test.d.ts.map

package/build/tools/replay-production-error-shape.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-production-error-shape.test.d.ts","sourceRoot":"","sources":["../../src/tools/replay-production-error-shape.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/build/tools/replay-production-error-shape.test.js

@@ -0,0 +1,93 @@
+/**
+ * Branches that were dead in production because they read `result.isError`,
+ * while the live executeToolCall raises the same failure as a ToolError. Each
+ * test drives the THROWN shape - the one that actually happens.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { autoLaunchChrome, getDebugState, probeLiveConnectionReferences } from './replay-executor.js';
+import { createErrorResponse, createSuccessResponse } from '../messages.js';
+import { productionShaped } from '../test-support/fake-execute-tool-call.js';
+const harness = (responses) => vi.fn(productionShaped(async (tool, params = {}) => {
+    const r = responses[`${tool}.${params.action}`] ?? responses[tool];
+    if (r === undefined)
+        return { content: [{ type: 'text', text: '' }] };
+    return typeof r === 'function' ? r(params) : r;
+}));
+describe('auto-launch failure', () => {
+    // The helper is called from inside ensureConnection's catch, so a throw here
+    // escaped the run entirely: the caller's LAUNCH_FAILED handling never ran and
+    // the user got a raw tool error instead of "launch Chrome manually first".
+    it('reports LAUNCH_FAILED when launchChrome throws', async () => {
+        const executeToolCall = harness({
+            launchChrome: createErrorResponse('CHROME_LAUNCH_TIMEOUT', { port: 9222, timeout: 30 }),
+        });
+        const result = await autoLaunchChrome(executeToolCall, 'device-a-one');
+        expect(result.success).toBe(false);
+        expect(result).toMatchObject({ errorType: 'LAUNCH_FAILED' });
+        expect(result.error).toContain('Failed to auto-launch Chrome');
+    });
+    it('succeeds quietly when Chrome launches', async () => {
+        const executeToolCall = harness({ launchChrome: { content: [{ type: 'text', text: 'Chrome launched' }] } });
+        expect(await autoLaunchChrome(executeToolCall, 'device-a-one')).toEqual({ success: true });
+    });
+});
+describe('debug state for an unpaused connection', () => {
+    const ctx = (executeToolCall) => ({ executeToolCall, connectionReason: 'device-a', logPrefix: 'test' });
+    // getCallStack answers "not paused" with an ERROR response, so the whole
+    // probe used to be abandoned - discarding the breakpoint count it had
+    // already read, for the ordinary unpaused run this exists to describe.
+    it('reports the breakpoint count when the debugger is simply not paused', async () => {
+        const executeToolCall = harness({
+            'breakpoint.list': { content: [{ type: 'text', text: '## Breakpoints\n\n**Total:** 2' }] },
+            'inspect.getCallStack': createErrorResponse('NOT_PAUSED'),
+        });
+        expect(await getDebugState(ctx(executeToolCall))).toEqual({
+            isPaused: false,
+            pauseLocation: undefined,
+            breakpointCount: 2,
+        });
+    });
+    it('reports the pause location when it IS paused', async () => {
+        const executeToolCall = harness({
+            'breakpoint.list': { content: [{ type: 'text', text: '**Total:** 1' }] },
+            'inspect.getCallStack': { content: [{ type: 'text', text: 'Paused at: app.js:42\n{"callFrameId":"f1"}' }] },
+        });
+        expect(await getDebugState(ctx(executeToolCall))).toMatchObject({
+            isPaused: true,
+            pauseLocation: 'app.js:42',
+            breakpointCount: 1,
+        });
+    });
+    // A failure that is NOT "not paused" still means the state is unknown.
+    it('gives up on any other call-stack failure', async () => {
+        const executeToolCall = harness({
+            'breakpoint.list': { content: [{ type: 'text', text: '**Total:** 1' }] },
+            'inspect.getCallStack': createErrorResponse('CONNECTION_NOT_FOUND', { connectionReason: 'device-a' }),
+        });
+        expect(await getDebugState(ctx(executeToolCall))).toBeNull();
+    });
+});
+describe('live connection probing', () => {
+    const connectionsResponse = (connections) => {
+        const response = createSuccessResponse('CONNECTIONS_LIST', { count: connections.length });
+        response.content[0].text += `\n\n\`\`\`json\n${JSON.stringify({ connections }, null, 2)}\n\`\`\``;
+        return response;
+    };
+    // A reference whose socket has dropped is not somewhere a step can run: if it
+    // counted as live, a healing sequence would skip the launch that replaces it.
+    it('does not count a disconnected reference as live', async () => {
+        const executeToolCall = harness({
+            listConnections: connectionsResponse([
+                { reference: 'device-a', port: 9222, connected: true },
+                { reference: 'device-b', port: 9223, connected: false },
+            ]),
+        });
+        const refs = await probeLiveConnectionReferences(executeToolCall);
+        expect(refs && [...refs]).toEqual(['device-a']);
+    });
+    it('treats an unreadable connection list as unknown, not empty', async () => {
+        const executeToolCall = harness({ listConnections: { content: [{ type: 'text', text: 'no json here' }] } });
+        expect(await probeLiveConnectionReferences(executeToolCall)).toBeNull();
+    });
+});
+//# sourceMappingURL=replay-production-error-shape.test.js.map

package/build/tools/replay-production-error-shape.test.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=replay-rebase.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-rebase.test.d.ts","sourceRoot":"","sources":["../../src/tools/replay-rebase.test.ts"],"names":[],"mappings":""}

package/build/tools/replay-rebase.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect } from 'vitest';
+import { rebaseSequence } from './replay-executor.js';
+const seq = (overrides = {}) => ({
+    id: 'seq-test',
+    name: 'test-seq',
+    startUrl: 'http://localhost:5174/?r=sh-1',
+    commands: [
+        { tool: 'navigate', params: { action: 'goto', url: 'http://localhost:5174/api/dev/enrol-link?prompt=employees-full' } },
+        { tool: 'request', params: { action: 'fetch', url: '/api/consumable', method: 'POST', body: { kind: 'draw' } } },
+        { tool: 'input', params: { action: 'click', selector: 'button:has-text("Alice")' } },
+        { tool: 'assert', params: { action: 'exists', urls: ['https://localhost:5174/a', 'not a url'] } },
+    ],
+    createdAt: 1,
+    ...overrides,
+});
+describe('rebaseSequence', () => {
+    it('rewrites the origin of startUrl and absolute command URLs, keeping path/query', () => {
+        const out = rebaseSequence(seq(), { baseUrl: 'https://cue-test.pages.dev' });
+        expect(out.startUrl).toBe('https://cue-test.pages.dev/?r=sh-1');
+        expect(out.commands[0].params.url).toBe('https://cue-test.pages.dev/api/dev/enrol-link?prompt=employees-full');
+    });
+    it('leaves relative URLs and non-URL strings untouched', () => {
+        const out = rebaseSequence(seq(), { baseUrl: 'https://cue-test.pages.dev' });
+        expect(out.commands[1].params.url).toBe('/api/consumable');
+        expect(out.commands[2].params.selector).toBe('button:has-text("Alice")');
+        expect(out.commands[3].params.urls[1]).toBe('not a url');
+    });
+    it('rebases strings nested in arrays and objects', () => {
+        const out = rebaseSequence(seq(), { baseUrl: 'https://cue-test.pages.dev' });
+        expect(out.commands[3].params.urls[0]).toBe('https://cue-test.pages.dev/a');
+        expect(out.commands[1].params.body).toEqual({ kind: 'draw' });
+    });
+    it('startUrl override replaces the entry URL wholesale', () => {
+        const out = rebaseSequence(seq(), {
+            baseUrl: 'https://cue-test.pages.dev',
+            startUrl: 'https://cue-test.pages.dev/?r=minted-xyz',
+        });
+        expect(out.startUrl).toBe('https://cue-test.pages.dev/?r=minted-xyz');
+        // commands still rebased
+        expect(out.commands[0].params.url).toBe('https://cue-test.pages.dev/api/dev/enrol-link?prompt=employees-full');
+    });
+    it('startUrl override works without a baseUrl', () => {
+        const out = rebaseSequence(seq(), { startUrl: 'https://other.example/?r=x' });
+        expect(out.startUrl).toBe('https://other.example/?r=x');
+        expect(out.commands[0].params.url).toBe('http://localhost:5174/api/dev/enrol-link?prompt=employees-full');
+    });
+    it('does not mutate the source sequence', () => {
+        const original = seq();
+        const before = JSON.parse(JSON.stringify(original));
+        rebaseSequence(original, { baseUrl: 'https://cue-test.pages.dev' });
+        expect(original).toEqual(before);
+    });
+    it('handles a sequence without a startUrl', () => {
+        const out = rebaseSequence(seq({ startUrl: undefined }), { baseUrl: 'https://cue-test.pages.dev' });
+        expect(out.startUrl).toBeUndefined();
+    });
+});
+//# sourceMappingURL=replay-rebase.test.js.map

package/build/tools/replay-rebase.test.js.map

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

package/build/tools/replay-retry-classification.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A click retries while the element is still mounting, and gives up at once on
+ * anything else. The predicate used to be a bare `includes('not found')`, which
+ * also caught CONNECTION_NOT_FOUND and SEQUENCE_NOT_FOUND - so a click against a
+ * dead connection spent five attempts and 2.5s re-asking a question that was
+ * answered on the first one.
+ */
+export {};
+//# sourceMappingURL=replay-retry-classification.test.d.ts.map

package/build/tools/replay-retry-classification.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-retry-classification.test.d.ts","sourceRoot":"","sources":["../../src/tools/replay-retry-classification.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/build/tools/replay-retry-classification.test.js

@@ -0,0 +1,57 @@
+/**
+ * A click retries while the element is still mounting, and gives up at once on
+ * anything else. The predicate used to be a bare `includes('not found')`, which
+ * also caught CONNECTION_NOT_FOUND and SEQUENCE_NOT_FOUND - so a click against a
+ * dead connection spent five attempts and 2.5s re-asking a question that was
+ * answered on the first one.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { executeCommandWithRetry } from './replay-executor.js';
+import { createErrorResponse } from '../messages.js';
+import { ToolError } from '../tool-error.js';
+const click = { action: 'click', selector: '#go' };
+/** Fails `failures` times with `response`, then succeeds. */
+function flaky(response, failures) {
+    let calls = 0;
+    const executeToolCall = vi.fn(async () => {
+        if (++calls <= failures)
+            throw new ToolError(response);
+        return { content: [{ type: 'text', text: 'Clicked' }] };
+    });
+    return { executeToolCall, calls: () => calls };
+}
+describe('element-not-found retries', () => {
+    it('retries a click while the element is still absent, then succeeds', async () => {
+        const { executeToolCall, calls } = flaky(createErrorResponse('ELEMENT_NOT_FOUND', { selector: '#go' }), 1);
+        const result = await executeCommandWithRetry(executeToolCall, 'input', click);
+        expect(result.success).toBe(true);
+        expect(calls()).toBe(2);
+    });
+    // The tightening: these all contain "not found" but none of them will start
+    // working if you ask again.
+    it.each(['CONNECTION_NOT_FOUND', 'SEQUENCE_NOT_FOUND', 'SERVER_NOT_FOUND'])('does not retry %s', async (messageId) => {
+        const { executeToolCall, calls } = flaky(createErrorResponse(messageId, { reference: 'x', name: 'x', id: 'x' }), 99);
+        const result = await executeCommandWithRetry(executeToolCall, 'input', click);
+        expect(result.success).toBe(false);
+        expect(calls()).toBe(1);
+    });
+    it('does not retry a non-retryable tool even for a missing element', async () => {
+        const { executeToolCall, calls } = flaky(createErrorResponse('ELEMENT_NOT_FOUND', { selector: '#go' }), 99);
+        const result = await executeCommandWithRetry(executeToolCall, 'dom', { action: 'querySelector', selector: '#go' });
+        expect(result.success).toBe(false);
+        expect(calls()).toBe(1);
+    });
+    // No _errorId to read: the text is all there is to go on.
+    it('classifies a puppeteer-phrased failure carrying no error id', async () => {
+        let n = 0;
+        const executeToolCall = vi.fn(async () => {
+            if (++n === 1)
+                throw new Error('No element found for selector: #go');
+            return { content: [{ type: 'text', text: 'Clicked' }] };
+        });
+        const result = await executeCommandWithRetry(executeToolCall, 'input', click);
+        expect(result.success).toBe(true);
+        expect(n).toBe(2);
+    });
+});
+//# sourceMappingURL=replay-retry-classification.test.js.map

package/build/tools/replay-retry-classification.test.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * Run Registry - tracks background sequence runs by run id.
+ *
+ * `replay({ action: 'run' })` returns a run id immediately and executes in the
+ * background; this registry is what `status` and `cancel` use to address a
+ * specific run. Held in memory only: a server restart (e.g. the supervisor's
+ * hot-restart on rebuild) kills any in-flight run with the process and
+ * forgets every id - callers polling an old id get REPLAY_RUN_NOT_FOUND.
+ */
+import type { StepResult } from './replay-executor.js';
+export type RunStatus = 'running' | 'cancelling' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export interface RunRecord {
+    runId: string;
+    sequenceId: string;
+    sequenceName: string;
+    connectionReason?: string;
+    status: RunStatus;
+    startedAt: number;
+    /** Set when the background execution settles (including on pause). */
+    endedAt?: number;
+    totalSteps: number;
+    /** 1-based step currently executing (or last reached). 0 = setup phase. */
+    currentStep: number;
+    currentTool?: string;
+    /** Top-level step results, populated when the run settles. */
+    results: StepResult[];
+    controller: AbortController;
+    /** The full tool response the old blocking `run` would have returned. */
+    finalResponse?: any;
+    /** Failure that escaped the run path itself (not a step failure). */
+    error?: string;
+}
+/** How long a settled run (completed/failed/cancelled/paused) stays retrievable. */
+export declare const RUN_RETENTION_MS: number;
+/** Hard cap on records; oldest settled runs are evicted first. */
+export declare const MAX_RUN_RECORDS = 50;
+declare class RunRegistry {
+    private runs;
+    private counter;
+    /** Ids are unique per process; the timestamp suffix keeps an id from a
+     *  previous server process from accidentally resolving after a restart. */
+    newRunId(): string;
+    register(record: RunRecord): void;
+    get(runId: string): RunRecord | undefined;
+    list(): RunRecord[];
+    /** Runs that are still executing (running or cancelling). */
+    active(): RunRecord[];
+    isSettled(record: RunRecord): boolean;
+    private prune;
+    /** Test hook. */
+    clear(): void;
+}
+export declare const runRegistry: RunRegistry;
+export {};
+//# sourceMappingURL=replay-run-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-run-registry.d.ts","sourceRoot":"","sources":["../../src/tools/replay-run-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;IAC5B,yEAAyE;IACzE,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAC/C,kEAAkE;AAClE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,cAAM,WAAW;IACf,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,OAAO,CAAK;IAEpB;+EAC2E;IAC3E,QAAQ,IAAI,MAAM;IAIlB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAKjC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKzC,IAAI,IAAI,SAAS,EAAE;IAKnB,6DAA6D;IAC7D,MAAM,IAAI,SAAS,EAAE;IAIrB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAIrC,OAAO,CAAC,KAAK;IAkBb,iBAAiB;IACjB,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}