devharness 0.8.0

package/build/tools/replay-teardown-and-foreach.test.js

@@ -0,0 +1,318 @@
+/**
+ * Two features that exist because a sequence suite drifts:
+ *
+ * 1. `teardown` - steps that run when the MAIN steps reach a terminal state,
+ *    including the states nothing else survives (a failed step, an abort, the
+ *    total timeout). A cleanup that only runs on the happy path is absent
+ *    exactly when it is needed.
+ * 2. `forEach` - conditions can only ask whether ONE named thing exists, so
+ *    "remove everything that shouldn't be here" was inexpressible. This
+ *    enumerates a source and runs a sequence per item.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { executeSteps, resolveForEachItems } from './replay-executor.js';
+import { formatExecutionResults } from './replay-formatters.js';
+import { configManager } from '../config.js';
+import { ToolError } from '../tool-error.js';
+function makeHarness(responses = {}, nested) {
+    const calls = [];
+    const executeToolCall = vi.fn(async (tool, params) => {
+        calls.push({ tool, params });
+        const key = `${tool}.${params.action}`;
+        const r = key in responses ? responses[key] : responses[tool];
+        const response = r !== undefined
+            ? (typeof r === 'function' ? r(params) : r)
+            : { content: [{ type: 'text', text: '' }] };
+        if (response?.isError)
+            throw new ToolError(response);
+        return response;
+    });
+    const commandRecorder = {
+        recordCommand: vi.fn(),
+        getCurrentHistoryIndex: () => 0,
+        getSequence: (id) => nested?.find(s => s.id === id),
+        getFreshSequence: async (id) => nested?.find(s => s.id === id),
+        listSequences: () => nested ?? [],
+        loadSequenceFromDisk: vi.fn(async () => null),
+        listSavedSequencesOnDisk: vi.fn(async () => []),
+    };
+    const ctx = {
+        executeToolCall,
+        commandRecorder,
+        connectionReason: 'device-a',
+        logPrefix: 'test',
+    };
+    return { calls, ctx, executeToolCall };
+}
+const seq = (name, commands, teardown) => ({
+    id: `seq-${name}`,
+    name,
+    commands,
+    ...(teardown ? { teardown } : {}),
+    createdAt: 1,
+});
+const text = (t) => ({ content: [{ type: 'text', text: t }] });
+const evaluated = (value) => ({
+    content: [{ type: 'text', text: 'ok' }],
+    _meta: { tool: 'inspect', action: 'evaluateExpression', timestamp: 0, inspect: { value } },
+});
+const errorText = (t) => ({ isError: true, content: [{ type: 'text', text: t }] });
+/**
+ * Which tool names ran, in order - the cheapest way to assert "cleanup
+ * happened". `inspect` is dropped: the executor makes its own probing calls
+ * around steps, and they are not what any of these tests are about.
+ */
+const toolsCalled = (calls) => calls.filter(c => c.tool !== 'inspect').map(c => c.tool);
+beforeEach(() => {
+    vi.spyOn(configManager, 'getClickValidationConfig').mockReturnValue({
+        enabled: false, validateNavigation: false, requireDomChanges: false,
+    });
+    vi.spyOn(configManager, 'getReplayConfig').mockReturnValue({
+        maxConditionalDepth: 10, maxRegexLength: 500,
+    });
+});
+describe('teardown', () => {
+    it('runs after the main steps succeed', async () => {
+        const { ctx, calls } = makeHarness({ screenshot: text('ok'), storage: text('cleared') });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        const result = await executeSteps({ sequence: s, ctx, startStep: 0 });
+        expect(result.results.every(r => r.success)).toBe(true);
+        expect(result.teardownResults).toHaveLength(1);
+        expect(result.teardownFailed).toBe(false);
+        expect(toolsCalled(calls)).toEqual(['screenshot', 'storage']);
+    });
+    it('runs even when a main step fails - the case cleanup exists for', async () => {
+        const { ctx, calls } = makeHarness({
+            screenshot: errorText('boom'),
+            storage: text('cleared'),
+        });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        const result = await executeSteps({ sequence: s, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(false);
+        expect(result.teardownResults).toHaveLength(1);
+        expect(result.teardownResults[0].success).toBe(true);
+        expect(toolsCalled(calls)).toContain('storage');
+    });
+    it('runs after the run is cancelled, because the signal is NOT passed down', async () => {
+        const controller = new AbortController();
+        const { ctx, calls } = makeHarness({ screenshot: text('ok'), storage: text('cleared') });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        controller.abort();
+        const result = await executeSteps({
+            sequence: s, ctx, startStep: 0, abortSignal: controller.signal,
+        });
+        expect(result.results[0].error).toBe('Replay aborted by user');
+        // The whole point: a cancelled run is precisely one that left something behind.
+        expect(result.teardownResults?.[0].success).toBe(true);
+        expect(toolsCalled(calls)).toEqual(['storage']);
+    });
+    it('has its own budget, so an exhausted totalTimeout does not skip it', async () => {
+        const { ctx, calls } = makeHarness({ screenshot: text('ok'), storage: text('cleared') });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        // totalTimeout of 0 means the main loop gives up before its first step.
+        const result = await executeSteps({ sequence: s, ctx, startStep: 0, totalTimeout: 0 });
+        expect(result.results[0].error).toContain('Total timeout exceeded');
+        expect(result.teardownResults?.[0].success).toBe(true);
+        expect(toolsCalled(calls)).toEqual(['storage']);
+    });
+    it('does NOT run when the sequence pauses at stepTo - the run is not over', async () => {
+        const { ctx, calls } = makeHarness({ screenshot: text('ok'), storage: text('cleared') });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }, { tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        const result = await executeSteps({ sequence: s, ctx, startStep: 0, endStep: 1 });
+        expect(result.teardownResults).toBeUndefined();
+        expect(toolsCalled(calls)).toEqual(['screenshot']);
+    });
+    it('reads variables the main steps captured, so it can undo what setup minted', async () => {
+        const { ctx, calls } = makeHarness({
+            request: {
+                content: [{ type: 'text', text: 'ok' }],
+                _meta: { tool: 'request', action: 'send', timestamp: 0, request: { body: { id: 'share-42' } } },
+            },
+            navigate: text('ok'),
+        });
+        const s = seq('main', [{ tool: 'request', params: { url: '/mint', saveAs: 'mint' } }], [{ tool: 'navigate', params: { action: 'goto', url: '/revoke/{{var:mint.body.id}}' } }]);
+        await executeSteps({ sequence: s, ctx, startStep: 0 });
+        const revoke = calls.find(c => c.tool === 'navigate');
+        expect(revoke?.params.url).toBe('/revoke/share-42');
+    });
+    it('does not change the run verdict when a teardown step fails', async () => {
+        const { ctx } = makeHarness({ navigate: text('ok'), storage: errorText('cleanup broke') });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        const result = await executeSteps({ sequence: s, ctx, startStep: 0 });
+        expect(result.results.every(r => r.success)).toBe(true);
+        expect(result.teardownFailed).toBe(true);
+        const rendered = formatExecutionResults('main', result.results, 1, 0, {
+            results: result.teardownResults, failed: true,
+        });
+        expect(rendered).toContain("does not change the run's verdict");
+        expect(rendered).toContain('**Successful:** 1');
+        expect(rendered).toContain('**Failed:** 0');
+    });
+    it('does not recurse - a teardown does not run its own teardown', async () => {
+        const { ctx, calls } = makeHarness({ screenshot: text('ok'), storage: text('cleared') });
+        const s = seq('main', [{ tool: 'screenshot', params: {} }], [{ tool: 'storage', params: {} }]);
+        await executeSteps({ sequence: s, ctx, startStep: 0 });
+        expect(calls.filter(c => c.tool === 'storage')).toHaveLength(1);
+    });
+});
+describe('resolveForEachItems', () => {
+    it('reads an array a previous saveAs captured', async () => {
+        const { ctx } = makeHarness();
+        ctx.variableStore = { rows: [{ id: 1 }, { id: 2 }] };
+        const result = await resolveForEachItems('{{var:rows}}', ctx);
+        expect(result).toEqual({ ok: true, items: [{ id: 1 }, { id: 2 }] });
+    });
+    it('addresses into a captured object', async () => {
+        const { ctx } = makeHarness();
+        ctx.variableStore = { list: { body: { shares: ['a', 'b'] } } };
+        const result = await resolveForEachItems('{{var:list.body.shares}}', ctx);
+        expect(result).toEqual({ ok: true, items: ['a', 'b'] });
+    });
+    it('rejects a non-array rather than looping over its characters', async () => {
+        const { ctx } = makeHarness();
+        ctx.variableStore = { name: 'employees' };
+        const result = await resolveForEachItems('{{var:name}}', ctx);
+        expect(result).toMatchObject({ ok: false });
+        expect(result.error).toContain('not an array');
+    });
+    it('names the missing variable instead of yielding nothing', async () => {
+        const { ctx } = makeHarness();
+        const result = await resolveForEachItems('{{var:nope}}', ctx);
+        expect(result.error).toContain('no variable named "nope"');
+    });
+    it('enumerates the DOM via selectorAll', async () => {
+        const { ctx, calls } = makeHarness({
+            'inspect.evaluateExpression': evaluated([{ index: 0, text: 'Employees' }]),
+        });
+        const result = await resolveForEachItems('{{selectorAll:.share-row}}', ctx);
+        expect(result).toEqual({ ok: true, items: [{ index: 0, text: 'Employees' }] });
+        expect(calls[0].params.expression).toContain('.share-row');
+    });
+    it('rejects an unrecognised source instead of treating it as empty', async () => {
+        const { ctx } = makeHarness();
+        const result = await resolveForEachItems('.share-row', ctx);
+        expect(result.error).toContain('unrecognised source');
+    });
+});
+describe('forEach step', () => {
+    const body = seq('revoke-one', [
+        { tool: 'storage', params: { action: 'setLocalStorage', key: 'revoked', value: '{{var:row.id}}' } },
+    ]);
+    /** What the body actually wrote, one entry per iteration. */
+    const revoked = (calls) => calls.filter(c => c.tool === 'storage').map(c => c.params.value);
+    it('runs the body once per item, binding each to `as`', async () => {
+        const { ctx, calls } = makeHarness({ storage: text('ok') }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one' } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a' }, { id: 'b' }, { id: 'c' }] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(true);
+        expect(result.results[0].iterations).toBe(3);
+        expect(result.results[0].itemsFound).toBe(3);
+        expect(revoked(calls)).toEqual(['a', 'b', 'c']);
+    });
+    it('an empty source is a success, not a failure', async () => {
+        const { ctx, calls } = makeHarness({ storage: text('ok') }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one' } },
+        ]);
+        ctx.variableStore = { rows: [] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(true);
+        expect(result.results[0].iterations).toBe(0);
+        expect(revoked(calls)).toEqual([]);
+    });
+    it('states the count when nothing ran, so an empty set is not mistaken for a broken selector', async () => {
+        const rendered = formatExecutionResults('main', [
+            { step: 1, tool: 'forEach', success: true, sequenceName: 'revoke-one', itemsFound: 0, iterations: 0 },
+        ], 1, 0);
+        expect(rendered).toContain('0 item(s) found, none ran');
+    });
+    it('filters with `where`, evaluated as JS with item in scope', async () => {
+        const { ctx, calls } = makeHarness({
+            storage: text('ok'),
+            'inspect.evaluateExpression': (params) => evaluated(!params.expression.includes('"keep":false')),
+        }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one', where: 'item.keep' } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a', keep: true }, { id: 'b', keep: false }] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].itemsFound).toBe(2);
+        expect(result.results[0].iterations).toBe(1);
+        expect(revoked(calls)).toEqual(['a']);
+    });
+    it('fails the step when `where` cannot be evaluated, rather than quietly excluding everything', async () => {
+        const { ctx } = makeHarness({
+            storage: text('ok'),
+            'inspect.evaluateExpression': errorText('SyntaxError'),
+        }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one', where: 'item.((' } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a' }] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(false);
+        expect(result.results[0].error).toContain('could not be evaluated');
+    });
+    it('stops the run when the body fails, naming which item', async () => {
+        const { ctx } = makeHarness({
+            storage: (params) => (params.value === 'b' ? errorText('nope') : text('ok')),
+        }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one' } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a' }, { id: 'b' }, { id: 'c' }] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(false);
+        expect(result.results[0].error).toContain('item 2/3');
+    });
+    it('caps iterations and says so rather than silently truncating', async () => {
+        const { ctx, calls } = makeHarness({ storage: text('ok') }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one', maxItems: 2 } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a' }, { id: 'b' }, { id: 'c' }] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].iterations).toBe(2);
+        expect(result.results[0].itemsFound).toBe(3);
+        expect(revoked(calls)).toEqual(['a', 'b']);
+    });
+    it('stops between iterations when the run is cancelled', async () => {
+        const controller = new AbortController();
+        const { ctx, calls } = makeHarness({
+            storage: () => { controller.abort(); return text('ok'); },
+        }, [body]);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'revoke-one' } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a' }, { id: 'b' }, { id: 'c' }] };
+        const result = await executeSteps({
+            sequence: main, ctx, startStep: 0, abortSignal: controller.signal,
+        });
+        expect(result.results[0].success).toBe(false);
+        expect(revoked(calls).length).toBeLessThan(3);
+    });
+    it('reports the missing parameters instead of failing mid-loop', async () => {
+        const { ctx } = makeHarness({}, [body]);
+        // A selectorAll source, so param interpolation leaves it alone and the
+        // step's own validation is what reports.
+        const main = seq('main', [{ tool: 'forEach', params: { in: '{{selectorAll:.row}}' } }]);
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(false);
+        expect(result.results[0].error).toContain('"as"');
+        expect(result.results[0].error).toContain('"do"');
+    });
+    it('names the sequence when the body does not exist', async () => {
+        const { ctx } = makeHarness({}, []);
+        const main = seq('main', [
+            { tool: 'forEach', params: { in: '{{var:rows}}', as: 'row', do: 'no-such-sequence' } },
+        ]);
+        ctx.variableStore = { rows: [{ id: 'a' }] };
+        const result = await executeSteps({ sequence: main, ctx, startStep: 0 });
+        expect(result.results[0].success).toBe(false);
+        expect(result.results[0].error).toContain('no-such-sequence');
+    });
+});
+//# sourceMappingURL=replay-teardown-and-foreach.test.js.map

package/build/tools/replay-teardown-and-foreach.test.js.map

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

package/build/tools/replay-tool-name-validation.test.d.ts

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

package/build/tools/replay-tool-name-validation.test.d.ts.map

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

package/build/tools/replay-tool-name-validation.test.js

@@ -0,0 +1,280 @@
+/**
+ * bug-010: sequence steps naming a nonexistent tool must be rejected at
+ * create/load time, before any step has mutated browser state.
+ */
+import { describe, it, expect, vi, beforeAll, afterAll } from 'vitest';
+import { promises as fsp } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { createReplayTools, findUnknownStepTools } from './replay-tools.js';
+import { CommandRecorder } from '../command-recorder.js';
+const KNOWN_TOOLS = ['navigate', 'inspect', 'input', 'screenshot', 'launchChrome'];
+const seq = (commands, name = 'hand-authored') => ({
+    id: 'seq-1',
+    name,
+    commands,
+    createdAt: 1,
+});
+function makeRecorder(sequence) {
+    return {
+        // Mirrors the real recorder: the parsed candidate is validated BEFORE it
+        // replaces any same-named sequence, and a rejected candidate is never stored.
+        loadSequenceFromDisk: vi.fn(async (_filename, options) => {
+            if (sequence && options?.validate && !options.validate(sequence))
+                return null;
+            return sequence;
+        }),
+        // Mirrors the real recorder: the candidate is validated BEFORE it is stored,
+        // and a rejected candidate is never stored at all (nothing to delete after).
+        createSequence: vi.fn(async (_name, _indices, options) => {
+            if (sequence && options?.validate && !options.validate(sequence))
+                return null;
+            return sequence;
+        }),
+        deleteSequence: vi.fn(() => true),
+        recordCommand: vi.fn(),
+    };
+}
+function makeReplay(sequence, getKnownToolNames) {
+    const recorder = makeRecorder(sequence);
+    const tools = createReplayTools(recorder, vi.fn(), undefined, undefined, getKnownToolNames);
+    return { recorder, replay: tools.replay };
+}
+const text = (res) => res.content[0].text;
+// ---------------------------------------------------------------------------
+// findUnknownStepTools
+// ---------------------------------------------------------------------------
+describe('findUnknownStepTools', () => {
+    it('returns nothing when every step names a known tool', () => {
+        const commands = [{ tool: 'navigate' }, { tool: 'inspect' }];
+        expect(findUnknownStepTools(commands, KNOWN_TOOLS)).toEqual([]);
+    });
+    it('reports 1-based step number and offending name', () => {
+        const commands = [{ tool: 'navigate' }, { tool: 'inpsect' }, { tool: 'nope' }];
+        const unknown = findUnknownStepTools(commands, KNOWN_TOOLS);
+        expect(unknown.map(u => ({ step: u.step, tool: u.tool }))).toEqual([
+            { step: 2, tool: 'inpsect' },
+            { step: 3, tool: 'nope' },
+        ]);
+    });
+    it('suggests a near-miss tool name for a typo', () => {
+        const [unknown] = findUnknownStepTools([{ tool: 'inpsect' }], KNOWN_TOOLS);
+        expect(unknown.suggestion).toBe('inspect');
+    });
+    it('accepts the "conditional" virtual step, which is not a registered tool', () => {
+        expect(findUnknownStepTools([{ tool: 'conditional' }], KNOWN_TOOLS)).toEqual([]);
+    });
+    it('flags a non-string tool field instead of throwing', () => {
+        const unknown = findUnknownStepTools([{ tool: undefined }, {}], KNOWN_TOOLS);
+        expect(unknown).toHaveLength(2);
+    });
+    it('does not inspect params (interpolation tokens must stay valid)', () => {
+        const commands = [
+            { tool: 'input', params: { action: 'click', x: '{{var:pos.x}}' } },
+            { tool: 'navigate', params: { url: '{{var:base}}/page?t={{timestamp}}' } },
+        ];
+        expect(findUnknownStepTools(commands, KNOWN_TOOLS)).toEqual([]);
+    });
+});
+// ---------------------------------------------------------------------------
+// load
+// ---------------------------------------------------------------------------
+describe('replay load - tool name validation', () => {
+    it('rejects a sequence with an unknown tool name when the provider is supplied', async () => {
+        const { replay, recorder } = makeReplay(seq([{ tool: 'navigate', params: {} }, { tool: 'inpsect', params: {} }]), () => KNOWN_TOOLS);
+        const res = await replay.handler({ action: 'load', filename: 'x.json' });
+        expect(res.isError).toBe(true);
+        expect(text(res)).toContain('Step 2');
+        expect(text(res)).toContain('inpsect');
+        expect(text(res)).toContain('inspect');
+        // rejected before storage, so there is nothing to clean up afterwards
+        expect(recorder.deleteSequence).not.toHaveBeenCalled();
+        // and nothing was pushed into history
+        expect(recorder.recordCommand).not.toHaveBeenCalled();
+    });
+    it('rejects before loading into history when intoHistory is set', async () => {
+        const { replay, recorder } = makeReplay(seq([{ tool: 'bogus', params: {} }]), () => KNOWN_TOOLS);
+        const res = await replay.handler({ action: 'load', filename: 'x.json', intoHistory: true });
+        expect(res.isError).toBe(true);
+        expect(recorder.recordCommand).not.toHaveBeenCalled();
+    });
+    it('loads a valid sequence normally', async () => {
+        const { replay, recorder } = makeReplay(seq([{ tool: 'navigate', params: {} }, { tool: 'conditional', params: {} }]), () => KNOWN_TOOLS);
+        const res = await replay.handler({ action: 'load', filename: 'x.json' });
+        expect(res.isError).toBeUndefined();
+        expect(recorder.deleteSequence).not.toHaveBeenCalled();
+    });
+    it('does not validate when no tool-name provider is supplied (previous behaviour)', async () => {
+        const { replay, recorder } = makeReplay(seq([{ tool: 'inpsect', params: {} }]));
+        const res = await replay.handler({ action: 'load', filename: 'x.json' });
+        expect(res.isError).toBeUndefined();
+        expect(recorder.deleteSequence).not.toHaveBeenCalled();
+    });
+    it('does not validate when the provider returns an empty list', async () => {
+        const { replay } = makeReplay(seq([{ tool: 'inpsect', params: {} }]), () => []);
+        const res = await replay.handler({ action: 'load', filename: 'x.json' });
+        expect(res.isError).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// create
+// ---------------------------------------------------------------------------
+describe('replay create - tool name validation', () => {
+    it('rejects a created sequence containing an unknown tool name', async () => {
+        const { replay, recorder } = makeReplay(seq([{ tool: 'ntavigate', params: {} }], 'from-history'), () => KNOWN_TOOLS);
+        const res = await replay.handler({ action: 'create', name: 'from-history', indices: [0] });
+        expect(res.isError).toBe(true);
+        expect(text(res)).toContain('Step 1');
+        expect(text(res)).toContain('ntavigate');
+        // Rejected before storage, so there is nothing to clean up afterwards
+        expect(recorder.deleteSequence).not.toHaveBeenCalled();
+    });
+    it('creates a valid sequence normally', async () => {
+        const { replay, recorder } = makeReplay(seq([{ tool: 'navigate', params: {} }], 'from-history'), () => KNOWN_TOOLS);
+        const res = await replay.handler({ action: 'create', name: 'from-history', indices: [0] });
+        expect(res.isError).toBeUndefined();
+        expect(recorder.deleteSequence).not.toHaveBeenCalled();
+    });
+    it('does not validate when no tool-name provider is supplied', async () => {
+        const { replay } = makeReplay(seq([{ tool: 'ntavigate', params: {} }], 'from-history'));
+        const res = await replay.handler({ action: 'create', name: 'from-history', indices: [0] });
+        expect(res.isError).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// create ordering: validation must run before the same-name replace
+// ---------------------------------------------------------------------------
+describe('replay create - a rejected create must not destroy the existing sequence', () => {
+    async function realRecorderReplay() {
+        const recorder = new CommandRecorder();
+        await recorder.recordCommand('navigate', { action: 'goto', url: 'http://example.test/' });
+        await recorder.recordCommand('ntavigate', { action: 'goto', url: 'http://example.test/bad' });
+        const { replay } = createReplayTools(recorder, vi.fn(), undefined, undefined, () => KNOWN_TOOLS);
+        return { recorder, replay };
+    }
+    it('keeps the good in-memory sequence when a same-named create is rejected', async () => {
+        const { recorder, replay } = await realRecorderReplay();
+        const good = await replay.handler({ action: 'create', name: 'login', indices: [0] });
+        expect(good.isError).toBeUndefined();
+        const goodId = recorder.listSequences()[0].id;
+        const bad = await replay.handler({ action: 'create', name: 'login', indices: [1] });
+        expect(bad.isError).toBe(true);
+        expect(text(bad)).toContain('ntavigate');
+        // the original survives, unchanged, under the same id - and nothing else was stored
+        const remaining = recorder.listSequences();
+        expect(remaining).toHaveLength(1);
+        expect(remaining[0].id).toBe(goodId);
+        expect(remaining[0].commands.map(c => c.tool)).toEqual(['navigate']);
+    });
+    it('still resolves the pre-existing sequence by name after a rejected create', async () => {
+        const { replay } = await realRecorderReplay();
+        await replay.handler({ action: 'create', name: 'login', indices: [0] });
+        await replay.handler({ action: 'create', name: 'login', indices: [1] });
+        const got = await replay.handler({ action: 'get', name: 'login' });
+        expect(got.isError).toBeUndefined();
+        expect(text(got)).toContain('navigate');
+        expect(text(got)).not.toContain('ntavigate');
+    });
+    it('replaces the existing sequence when the new one is valid (dedupe still works, #75)', async () => {
+        const { recorder, replay } = await realRecorderReplay();
+        await recorder.recordCommand('inspect', { action: 'evaluateExpression', expression: '1+1' });
+        await replay.handler({ action: 'create', name: 'login', indices: [0] });
+        const res = await replay.handler({ action: 'create', name: 'login', indices: [0, 2] });
+        expect(res.isError).toBeUndefined();
+        const remaining = recorder.listSequences();
+        expect(remaining).toHaveLength(1);
+        expect(remaining[0].commands.map(c => c.tool)).toEqual(['navigate', 'inspect']);
+    });
+});
+// ---------------------------------------------------------------------------
+// load ordering: validation must run before the same-name replace
+// (same defect class as the create path above, on the disk-load path)
+// ---------------------------------------------------------------------------
+describe('replay load - a rejected load must not destroy the existing sequence', () => {
+    let dir;
+    beforeAll(async () => {
+        dir = await fsp.mkdtemp(join(tmpdir(), 'replay-load-order-'));
+    });
+    afterAll(async () => {
+        await fsp.rm(dir, { recursive: true, force: true });
+    });
+    /** Write a sequence file and return its absolute path (load takes absolute paths as-is). */
+    async function writeSequenceFile(file, sequence) {
+        const filepath = join(dir, file);
+        await fsp.writeFile(filepath, JSON.stringify(sequence), 'utf-8');
+        return filepath;
+    }
+    /** Real recorder holding one good in-memory sequence named "login". */
+    async function withGoodSequence() {
+        const recorder = new CommandRecorder();
+        await recorder.recordCommand('navigate', { action: 'goto', url: 'http://example.test/' });
+        const { replay } = createReplayTools(recorder, vi.fn(), undefined, undefined, () => KNOWN_TOOLS);
+        const created = await replay.handler({ action: 'create', name: 'login', indices: [0] });
+        expect(created.isError).toBeUndefined();
+        const goodId = recorder.listSequences()[0].id;
+        return { recorder, replay, goodId };
+    }
+    it('keeps the good in-memory sequence when a same-named load is rejected', async () => {
+        const { recorder, replay, goodId } = await withGoodSequence();
+        const filepath = await writeSequenceFile('bad.json', {
+            id: 'seq-from-disk-bad',
+            name: 'login',
+            commands: [{ tool: 'ntavigate', params: {} }],
+            createdAt: 2,
+        });
+        const res = await replay.handler({ action: 'load', filename: filepath });
+        expect(res.isError).toBe(true);
+        expect(text(res)).toContain('ntavigate');
+        // the original survives, unchanged, under the same id - and nothing else was stored
+        const remaining = recorder.listSequences();
+        expect(remaining).toHaveLength(1);
+        expect(remaining[0].id).toBe(goodId);
+        expect(remaining[0].commands.map(c => c.tool)).toEqual(['navigate']);
+        expect(recorder.getSequence('seq-from-disk-bad')).toBeUndefined();
+    });
+    it('still resolves the pre-existing sequence by name after a rejected load', async () => {
+        const { replay } = await withGoodSequence();
+        const filepath = await writeSequenceFile('bad-get.json', {
+            id: 'seq-from-disk-bad-2',
+            name: 'login',
+            commands: [{ tool: 'ntavigate', params: {} }],
+            createdAt: 2,
+        });
+        await replay.handler({ action: 'load', filename: filepath });
+        const got = await replay.handler({ action: 'get', name: 'login' });
+        expect(got.isError).toBeUndefined();
+        expect(text(got)).toContain('navigate');
+        expect(text(got)).not.toContain('ntavigate');
+    });
+    it('records nothing into history when a load with intoHistory is rejected', async () => {
+        const { recorder, replay, goodId } = await withGoodSequence();
+        const before = recorder.getStats().historyCount;
+        const filepath = await writeSequenceFile('bad-history.json', {
+            id: 'seq-from-disk-bad-3',
+            name: 'login',
+            commands: [{ tool: 'ntavigate', params: {} }],
+            createdAt: 2,
+        });
+        const res = await replay.handler({ action: 'load', filename: filepath, intoHistory: true });
+        expect(res.isError).toBe(true);
+        expect(recorder.getStats().historyCount).toBe(before);
+        expect(recorder.listSequences()).toHaveLength(1);
+        expect(recorder.listSequences()[0].id).toBe(goodId);
+    });
+    it('replaces the existing same-named sequence when the loaded one is valid', async () => {
+        const { recorder, replay } = await withGoodSequence();
+        const filepath = await writeSequenceFile('good.json', {
+            id: 'seq-from-disk-good',
+            name: 'login',
+            commands: [{ tool: 'navigate', params: {} }, { tool: 'inspect', params: {} }],
+            createdAt: 2,
+        });
+        const res = await replay.handler({ action: 'load', filename: filepath });
+        expect(res.isError).toBeUndefined();
+        const remaining = recorder.listSequences();
+        expect(remaining).toHaveLength(1);
+        expect(remaining[0].id).toBe('seq-from-disk-good');
+        expect(remaining[0].commands.map(c => c.tool)).toEqual(['navigate', 'inspect']);
+    });
+});
+//# sourceMappingURL=replay-tool-name-validation.test.js.map