@isoldex/sentinel 0.1.0 → 2.0.0

package/dist/__tests__/state-parser.test.js

@@ -0,0 +1,176 @@
+import { jest, describe, it, expect } from '@jest/globals';
+import { StateParser } from '../core/state-parser.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeNode(role, name, backendDOMNodeId = 1, ignored = false) {
+    return {
+        role: { value: role },
+        name: { value: name },
+        description: { value: '' },
+        backendDOMNodeId,
+        ignored,
+        properties: [],
+    };
+}
+function makeBoxModel(x = 10, y = 20, width = 100, height = 30) {
+    return {
+        model: {
+            // CDP box model: [x0,y0, x1,y0, x1,y1, x0,y1] (8 values)
+            content: [x, y, x + width, y, x + width, y + height, x, y + height],
+        },
+    };
+}
+function makeMockCDP(nodes, boxModels) {
+    return {
+        send: jest.fn(async (method, params) => {
+            if (method === 'Accessibility.getFullAXTree')
+                return { nodes };
+            if (method === 'DOM.getBoxModel') {
+                const idx = nodes.findIndex((n) => n.backendDOMNodeId === params?.backendNodeId);
+                return boxModels[idx] ?? makeBoxModel();
+            }
+            return {};
+        }),
+    };
+}
+function makeMockPage(url = 'https://example.com', title = 'Example') {
+    return {
+        url: () => url,
+        title: jest.fn(async () => title),
+        evaluate: jest.fn(async () => []),
+    };
+}
+// ─── Tests ────────────────────────────────────────────────────────────────────
+describe('StateParser', () => {
+    it('returns url and title from page', async () => {
+        const nodes = [makeNode('button', 'Submit', 1)];
+        const cdp = makeMockCDP(nodes, [makeBoxModel()]);
+        const page = makeMockPage('https://test.com', 'Test Page');
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.url).toBe('https://test.com');
+        expect(state.title).toBe('Test Page');
+    });
+    it('parses interactive button element correctly', async () => {
+        const nodes = [makeNode('button', 'Login', 42)];
+        const cdp = makeMockCDP(nodes, [makeBoxModel(5, 10, 80, 25)]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.elements).toHaveLength(1);
+        const el = state.elements[0];
+        expect(el.role).toBe('button');
+        expect(el.name).toBe('Login');
+        expect(el.boundingClientRect.x).toBe(5);
+        expect(el.boundingClientRect.y).toBe(10);
+        expect(el.boundingClientRect.width).toBe(80);
+        expect(el.boundingClientRect.height).toBe(25);
+    });
+    it('filters out non-interactive roles', async () => {
+        const nodes = [
+            makeNode('generic', 'Some div', 1),
+            makeNode('heading', 'Title', 2),
+            makeNode('link', 'Click me', 3),
+        ];
+        const cdp = makeMockCDP(nodes, [makeBoxModel(), makeBoxModel(), makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        // Only 'link' is interactive
+        expect(state.elements).toHaveLength(1);
+        expect(state.elements[0].role).toBe('link');
+    });
+    it('filters out ignored nodes', async () => {
+        const nodes = [
+            makeNode('button', 'Hidden', 1, true), // ignored = true
+            makeNode('button', 'Visible', 2, false),
+        ];
+        const cdp = makeMockCDP(nodes, [makeBoxModel(), makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.elements).toHaveLength(1);
+        expect(state.elements[0].name).toBe('Visible');
+    });
+    it('filters out nameless non-textbox elements', async () => {
+        const nodes = [
+            makeNode('button', '', 1), // no name → filtered
+            makeNode('textbox', '', 2), // textbox without name → kept
+        ];
+        const cdp = makeMockCDP(nodes, [makeBoxModel(), makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.elements).toHaveLength(1);
+        expect(state.elements[0].role).toBe('textbox');
+    });
+    it('uses description as fallback name', async () => {
+        const node = {
+            role: { value: 'button' },
+            name: { value: '' },
+            description: { value: 'Close dialog' },
+            backendDOMNodeId: 1,
+            ignored: false,
+            properties: [],
+        };
+        const cdp = makeMockCDP([node], [makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.elements[0].name).toBe('Close dialog');
+    });
+    it('caches state within TTL', async () => {
+        const nodes = [makeNode('button', 'OK', 1)];
+        const cdp = makeMockCDP(nodes, [makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        await parser.parse();
+        await parser.parse(); // second call – should use cache
+        // CDP.send for getFullAXTree should only be called once
+        const axCalls = cdp.send.mock.calls.filter((c) => c[0] === 'Accessibility.getFullAXTree');
+        expect(axCalls).toHaveLength(1);
+    });
+    it('invalidateCache forces fresh parse', async () => {
+        const nodes = [makeNode('button', 'OK', 1)];
+        const cdp = makeMockCDP(nodes, [makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        await parser.parse();
+        parser.invalidateCache();
+        await parser.parse();
+        const axCalls = cdp.send.mock.calls.filter((c) => c[0] === 'Accessibility.getFullAXTree');
+        expect(axCalls).toHaveLength(2);
+    });
+    it('assigns incrementing ids to elements', async () => {
+        const nodes = [
+            makeNode('button', 'A', 1),
+            makeNode('link', 'B', 2),
+            makeNode('textbox', 'C', 3),
+        ];
+        const cdp = makeMockCDP(nodes, [makeBoxModel(), makeBoxModel(), makeBoxModel()]);
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.elements.map((e) => e.id)).toEqual([0, 1, 2]);
+    });
+    it('skips elements where box model is rejected', async () => {
+        const nodes = [makeNode('button', 'Broken', 1), makeNode('link', 'Good', 2)];
+        const cdp = {
+            send: jest.fn(async (method, params) => {
+                if (method === 'Accessibility.getFullAXTree')
+                    return { nodes };
+                if (method === 'DOM.getBoxModel') {
+                    if (params?.backendNodeId === 1)
+                        throw new Error('not found');
+                    return makeBoxModel();
+                }
+                return {};
+            }),
+        };
+        const page = makeMockPage();
+        const parser = new StateParser(page, cdp);
+        const state = await parser.parse();
+        expect(state.elements).toHaveLength(1);
+        expect(state.elements[0].name).toBe('Good');
+    });
+});
+//# sourceMappingURL=state-parser.test.js.map

package/dist/__tests__/state-parser.test.js.map

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

package/dist/__tests__/verifier.test.d.ts

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

package/dist/__tests__/verifier.test.d.ts.map

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

package/dist/__tests__/verifier.test.js

@@ -0,0 +1,68 @@
+import { jest, describe, it, expect } from '@jest/globals';
+import { Verifier } from '../reliability/verifier.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeState(overrides = {}) {
+    return {
+        url: 'https://example.com',
+        title: 'Example',
+        elements: [],
+        ...overrides,
+    };
+}
+function makeMockLLM(response) {
+    return {
+        generateStructuredData: jest.fn(async () => response),
+        generateText: jest.fn(async () => ''),
+    };
+}
+// ─── Tests ────────────────────────────────────────────────────────────────────
+describe('Verifier', () => {
+    it('auto-succeeds when URL changes (fast path)', async () => {
+        const llm = makeMockLLM({ success: false, confidence: 0, explanation: 'should not be called' });
+        const verifier = new Verifier({}, {}, llm);
+        const before = makeState({ url: 'https://example.com/login' });
+        const after = makeState({ url: 'https://example.com/dashboard' });
+        const result = await verifier.verifyAction('Click login button', before, after);
+        expect(result.success).toBe(true);
+        expect(result.confidence).toBeGreaterThanOrEqual(0.9);
+        expect(llm.generateStructuredData).not.toHaveBeenCalled();
+    });
+    it('calls LLM when URL stays the same', async () => {
+        const llm = makeMockLLM({ success: true, confidence: 0.85, explanation: 'Form was submitted' });
+        const verifier = new Verifier({}, {}, llm);
+        const before = makeState({ elements: [] });
+        const after = makeState({ elements: [{ id: 0, role: 'alert', name: 'Success!', boundingClientRect: { x: 0, y: 0, width: 100, height: 30 } }] });
+        const result = await verifier.verifyAction('Submit form', before, after);
+        expect(llm.generateStructuredData).toHaveBeenCalledTimes(1);
+        expect(result.success).toBe(true);
+        expect(result.confidence).toBe(0.85);
+        expect(result.message).toBe('Form was submitted');
+    });
+    it('returns failure when LLM says action failed', async () => {
+        const llm = makeMockLLM({ success: false, confidence: 0.3, explanation: 'Nothing changed' });
+        const verifier = new Verifier({}, {}, llm);
+        const state = makeState();
+        const result = await verifier.verifyAction('Click invisible button', state, state);
+        expect(result.success).toBe(false);
+        expect(result.confidence).toBe(0.3);
+    });
+    it('always sets done: true', async () => {
+        const llm = makeMockLLM({ success: true, confidence: 0.9, explanation: 'OK' });
+        const verifier = new Verifier({}, {}, llm);
+        const state = makeState();
+        const result = await verifier.verifyAction('Any action', state, state);
+        expect(result.done).toBe(true);
+    });
+    it('passes action description and both states to LLM prompt', async () => {
+        const llm = makeMockLLM({ success: true, confidence: 0.8, explanation: 'Done' });
+        const verifier = new Verifier({}, {}, llm);
+        const before = makeState({ title: 'Before Page' });
+        const after = makeState({ title: 'After Page' });
+        await verifier.verifyAction('Fill in email', before, after);
+        const promptArg = llm.generateStructuredData.mock.calls[0][0];
+        expect(promptArg).toContain('Fill in email');
+        expect(promptArg).toContain('Before Page');
+        expect(promptArg).toContain('After Page');
+    });
+});
+//# sourceMappingURL=verifier.test.js.map

package/dist/__tests__/verifier.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.test.js","sourceRoot":"","sources":["../../src/__tests__/verifier.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAItD,iFAAiF;AAEjF,SAAS,SAAS,CAAC,YAAsC,EAAE;IACzD,OAAO;QACL,GAAG,EAAE,qBAAqB;QAC1B,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,EAAE;QACZ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAuE;IAC1F,OAAO;QACL,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAQ;QAC5D,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAS,EAAE,EAAS,EAAE,GAAG,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAEhF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAS,EAAE,EAAS,EAAE,GAAG,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAEhJ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAEzE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC7F,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAS,EAAE,EAAS,EAAE,GAAG,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,wBAAwB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAEnF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAS,EAAE,EAAS,EAAE,GAAG,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAEvE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAS,EAAE,EAAS,EAAE,GAAG,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAEjD,MAAM,QAAQ,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAE5D,MAAM,SAAS,GAAK,GAAG,CAAC,sBAAoC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC,CAAC,CAAW,CAAC;QAClG,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/workflow-recorder.test.d.ts

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

package/dist/__tests__/workflow-recorder.test.d.ts.map

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

package/dist/__tests__/workflow-recorder.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from '@jest/globals';
+import { WorkflowRecorder } from '../recorder/workflow-recorder.js';
+describe('WorkflowRecorder', () => {
+    it('starts and stops recording, returning a workflow', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.startRecording('My Workflow');
+        recorder.record({ type: 'goto', url: 'https://example.com', pageUrl: 'https://example.com', pageTitle: 'Example' });
+        recorder.record({ type: 'act', instruction: 'Click login', pageUrl: 'https://example.com', pageTitle: 'Example' });
+        const workflow = recorder.stopRecording();
+        expect(workflow.name).toBe('My Workflow');
+        expect(workflow.steps).toHaveLength(2);
+        expect(workflow.steps[0].type).toBe('goto');
+        expect(workflow.steps[1].type).toBe('act');
+    });
+    it('does not record steps when not recording', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.record({ type: 'act', instruction: 'Click something', pageUrl: '', pageTitle: '' });
+        recorder.startRecording();
+        const workflow = recorder.stopRecording();
+        expect(workflow.steps).toHaveLength(0);
+    });
+    it('exportAsJSON returns valid JSON with steps', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.startRecording('Test');
+        recorder.record({ type: 'goto', url: 'https://test.com', pageUrl: 'https://test.com', pageTitle: 'Test' });
+        const workflow = recorder.stopRecording();
+        const json = recorder.exportAsJSON(workflow);
+        const parsed = JSON.parse(json);
+        expect(parsed.name).toBe('Test');
+        expect(Array.isArray(parsed.steps)).toBe(true);
+        expect(parsed.steps).toHaveLength(1);
+    });
+    it('exportAsCode returns TypeScript string containing goto url', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.startRecording('Code Export');
+        recorder.record({ type: 'goto', url: 'https://example.com', pageUrl: 'https://example.com', pageTitle: '' });
+        recorder.record({ type: 'act', instruction: 'Click submit', pageUrl: 'https://example.com', pageTitle: '' });
+        const workflow = recorder.stopRecording();
+        const code = recorder.exportAsCode(workflow);
+        expect(code).toContain('https://example.com');
+        expect(code).toContain('Click submit');
+        expect(typeof code).toBe('string');
+    });
+    it('uses default name when none provided', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.startRecording();
+        const workflow = recorder.stopRecording();
+        expect(typeof workflow.name).toBe('string');
+        expect(workflow.name.length).toBeGreaterThan(0);
+    });
+    it('records timestamp on each step', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.startRecording();
+        recorder.record({ type: 'act', instruction: 'Click', pageUrl: '', pageTitle: '' });
+        const workflow = recorder.stopRecording();
+        expect(workflow.steps[0]).toHaveProperty('timestamp');
+    });
+    it('resets steps on new startRecording call', () => {
+        const recorder = new WorkflowRecorder();
+        recorder.startRecording('First');
+        recorder.record({ type: 'act', instruction: 'Step 1', pageUrl: '', pageTitle: '' });
+        recorder.stopRecording();
+        recorder.startRecording('Second');
+        recorder.record({ type: 'act', instruction: 'Step A', pageUrl: '', pageTitle: '' });
+        recorder.record({ type: 'act', instruction: 'Step B', pageUrl: '', pageTitle: '' });
+        const workflow = recorder.stopRecording();
+        expect(workflow.name).toBe('Second');
+        expect(workflow.steps).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=workflow-recorder.test.js.map

package/dist/__tests__/workflow-recorder.test.js.map

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

package/dist/agent/agent-loop.d.ts

@@ -0,0 +1,36 @@
+import type { ActionEngine } from '../api/act.js';
+import type { StateParser } from '../core/state-parser.js';
+import type { LLMProvider } from '../utils/llm-provider.js';
+export interface AgentRunOptions {
+    maxSteps?: number;
+    onStep?: (step: AgentStepEvent) => void;
+}
+export interface AgentStepEvent {
+    stepNumber: number;
+    instruction: string;
+    reasoning: string;
+    success: boolean;
+    pageUrl: string;
+    pageTitle: string;
+}
+export interface AgentResult {
+    success: boolean;
+    goalAchieved: boolean;
+    totalSteps: number;
+    message: string;
+    history: AgentStepEvent[];
+}
+/**
+ * Autonomous multi-step agent loop.
+ * Implements a Plan → Execute → Verify → Reflect cycle.
+ */
+export declare class AgentLoop {
+    private actionEngine;
+    private stateParser;
+    private gemini;
+    private planner;
+    private memory;
+    constructor(actionEngine: ActionEngine, stateParser: StateParser, gemini: LLMProvider);
+    run(goal: string, options?: AgentRunOptions): Promise<AgentResult>;
+}
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/agent/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/agent/agent-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,SAAS;IAKlB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAc;gBAGlB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW;IAMvB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;CAqH7E"}

package/dist/agent/agent-loop.js

@@ -0,0 +1,127 @@
+import { AgentMemory } from './memory.js';
+import { Planner } from './planner.js';
+/**
+ * Autonomous multi-step agent loop.
+ * Implements a Plan → Execute → Verify → Reflect cycle.
+ */
+export class AgentLoop {
+    actionEngine;
+    stateParser;
+    gemini;
+    planner;
+    memory;
+    constructor(actionEngine, stateParser, gemini) {
+        this.actionEngine = actionEngine;
+        this.stateParser = stateParser;
+        this.gemini = gemini;
+        this.planner = new Planner(gemini);
+        this.memory = new AgentMemory(20);
+    }
+    async run(goal, options = {}) {
+        const maxSteps = options.maxSteps ?? 15;
+        const stepEvents = [];
+        this.memory.clear();
+        console.log(`[Agent] 🎯 Goal: "${goal}" (max ${maxSteps} steps)`);
+        let stepNumber = 0;
+        let consecutiveFailures = 0;
+        while (stepNumber < maxSteps) {
+            stepNumber++;
+            console.log(`[Agent] 📍 Step ${stepNumber}/${maxSteps}`);
+            // 1. Parse current state
+            this.stateParser.invalidateCache();
+            const state = await this.stateParser.parse();
+            // 2. Plan next step
+            let planned;
+            try {
+                planned = await this.planner.planNextStep(goal, state, this.memory);
+            }
+            catch (err) {
+                console.error(`[Agent] Planner error: ${err.message}`);
+                break;
+            }
+            console.log(`[Agent] 💭 Plan: "${planned.instruction}" — ${planned.reasoning}`);
+            // 3. Check if goal is already complete
+            if (planned.isGoalComplete) {
+                console.log(`[Agent] ✅ Goal marked complete by planner.`);
+                const event = {
+                    stepNumber,
+                    instruction: planned.instruction,
+                    reasoning: planned.reasoning,
+                    success: true,
+                    pageUrl: state.url,
+                    pageTitle: state.title,
+                };
+                stepEvents.push(event);
+                options.onStep?.(event);
+                return {
+                    success: true,
+                    goalAchieved: true,
+                    totalSteps: stepNumber,
+                    message: `Goal achieved in ${stepNumber} step(s).`,
+                    history: stepEvents,
+                };
+            }
+            // 4. Execute the planned step
+            let result;
+            try {
+                result = await this.actionEngine.act(planned.instruction);
+            }
+            catch (err) {
+                result = { success: false, message: err.message, action: planned.instruction };
+            }
+            const event = {
+                stepNumber,
+                instruction: planned.instruction,
+                reasoning: planned.reasoning,
+                success: result.success,
+                pageUrl: state.url,
+                pageTitle: state.title,
+            };
+            stepEvents.push(event);
+            options.onStep?.(event);
+            // 5. Record in memory
+            this.memory.add({
+                stepNumber,
+                instruction: planned.instruction,
+                action: result.action ?? planned.instruction,
+                success: result.success,
+                pageUrl: state.url,
+                pageTitle: state.title,
+                timestamp: Date.now(),
+            });
+            if (!result.success) {
+                consecutiveFailures++;
+                console.warn(`[Agent] ⚠️  Step failed (${consecutiveFailures} consecutive): ${result.message}`);
+                if (consecutiveFailures >= 3) {
+                    console.error(`[Agent] ❌ Aborting: 3 consecutive failures.`);
+                    break;
+                }
+            }
+            else {
+                consecutiveFailures = 0;
+            }
+        }
+        // 6. Final reflection – did we actually achieve the goal?
+        this.stateParser.invalidateCache();
+        const finalState = await this.stateParser.parse();
+        let goalAchieved = false;
+        try {
+            goalAchieved = await this.planner.reflect(goal, this.memory, finalState);
+        }
+        catch {
+            goalAchieved = false;
+        }
+        const message = goalAchieved
+            ? `Goal achieved in ${stepNumber} step(s).`
+            : `Agent stopped after ${stepNumber} step(s) without fully achieving the goal.`;
+        console.log(`[Agent] ${goalAchieved ? '✅' : '⚠️ '} ${message}`);
+        return {
+            success: goalAchieved,
+            goalAchieved,
+            totalSteps: stepNumber,
+            message,
+            history: stepEvents,
+        };
+    }
+}
+//# sourceMappingURL=agent-loop.js.map

package/dist/agent/agent-loop.js.map

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

package/dist/agent/memory.d.ts

@@ -0,0 +1,24 @@
+export interface StepRecord {
+    stepNumber: number;
+    instruction: string;
+    action: string;
+    success: boolean;
+    pageUrl: string;
+    pageTitle: string;
+    timestamp: number;
+}
+/**
+ * Sliding context window over agent step history.
+ * Keeps the last N steps to avoid exceeding LLM context limits.
+ */
+export declare class AgentMemory {
+    private readonly maxSteps;
+    private history;
+    constructor(maxSteps?: number);
+    add(record: StepRecord): void;
+    getHistory(): StepRecord[];
+    getSummary(): string;
+    clear(): void;
+    get length(): number;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/agent/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,OAAO,CAAoB;gBAEN,QAAQ,GAAE,MAAW;IAElD,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAO7B,UAAU,IAAI,UAAU,EAAE;IAI1B,UAAU,IAAI,MAAM;IAUpB,KAAK,IAAI,IAAI;IAIb,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/agent/memory.js

@@ -0,0 +1,34 @@
+/**
+ * Sliding context window over agent step history.
+ * Keeps the last N steps to avoid exceeding LLM context limits.
+ */
+export class AgentMemory {
+    maxSteps;
+    history = [];
+    constructor(maxSteps = 20) {
+        this.maxSteps = maxSteps;
+    }
+    add(record) {
+        this.history.push(record);
+        if (this.history.length > this.maxSteps) {
+            this.history.shift();
+        }
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    getSummary() {
+        if (this.history.length === 0)
+            return 'No steps taken yet.';
+        return this.history
+            .map(s => `Step ${s.stepNumber}: [${s.success ? 'OK' : 'FAIL'}] ${s.instruction} → ${s.action} (${s.pageTitle})`)
+            .join('\n');
+    }
+    clear() {
+        this.history = [];
+    }
+    get length() {
+        return this.history.length;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/agent/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,WAAW;IAGO;IAFrB,OAAO,GAAiB,EAAE,CAAC;IAEnC,YAA6B,WAAmB,EAAE;QAArB,aAAQ,GAAR,QAAQ,CAAa;IAAG,CAAC;IAEtD,GAAG,CAAC,MAAkB;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAC5D,OAAO,IAAI,CAAC,OAAO;aAChB,GAAG,CACF,CAAC,CAAC,EAAE,CACF,QAAQ,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,GAAG,CACzG;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;CACF"}

package/dist/agent/planner.d.ts

@@ -0,0 +1,18 @@
+import type { LLMProvider } from '../utils/llm-provider.js';
+import type { SimplifiedState } from '../core/state-parser.js';
+import type { AgentMemory } from './memory.js';
+export interface PlannedStep {
+    instruction: string;
+    reasoning: string;
+    isGoalComplete: boolean;
+}
+/**
+ * Uses Gemini to plan the next action step based on the current page state and history.
+ */
+export declare class Planner {
+    private gemini;
+    constructor(gemini: LLMProvider);
+    planNextStep(goal: string, state: SimplifiedState, memory: AgentMemory): Promise<PlannedStep>;
+    reflect(goal: string, memory: AgentMemory, finalState: SimplifiedState): Promise<boolean>;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/agent/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agent/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEjC,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC;IAuCjB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;CAgChG"}