devharness 0.8.0

package/build/tools/wait-tools.js

@@ -0,0 +1,236 @@
+/**
+ * Wait Tool - a first-class wait primitive for sequences (bug-016)
+ *
+ * Four mutually exclusive forms:
+ *   wait({ selector })      - until an element matching the selector exists
+ *   wait({ selectorGone })  - until NO element matches the selector
+ *   wait({ expression })    - until a synchronous JS expression is truthy
+ *   wait({ ms })            - fixed sleep (last resort)
+ *
+ * All condition forms poll from the MCP side: the predicate is a SYNCHRONOUS
+ * expression re-evaluated over CDP on an interval. This is deliberate - it is
+ * NOT an in-page waitForFunction/waitForSelector:
+ *
+ * - It survives a navigation mid-wait. Each poll runs in whatever execution
+ *   context the page currently has; if the context is destroyed between
+ *   polls (navigation), the failed poll is swallowed and the next one runs
+ *   in the new document. This is exactly the "step after navigate races the
+ *   new page" case that motivated the tool.
+ * - It does not depend on the page's event loop making progress or on any
+ *   in-page promise ever resolving, so it still behaves sanely when the page
+ *   is busy - and it fails fast instead of burning the timeout when the
+ *   debugger is paused (nothing can change while the event loop is stopped).
+ */
+import { z } from 'zod';
+import { createTool } from '../validation-helpers.js';
+import { createErrorResponse, createSuccessResponse } from '../messages.js';
+import { isExtendedSelector, parseExtendedSelector } from '../utils/selector-resolver.js';
+import { abortableSleep, isAbortError, throwIfAborted } from '../utils/abort.js';
+const waitSchema = z.object({
+    selector: z.string().optional().describe('Wait until an element matching this CSS selector exists. Supports extended selectors: :has-text("text") partial match, :text("text") exact match. Survives navigations that happen mid-wait.'),
+    selectorGone: z.string().optional().describe('Wait until NO element matches this CSS selector (spinner removed, modal closed). Same selector syntax as selector.'),
+    expression: z.string().optional().describe('Wait until this SYNCHRONOUS JavaScript expression evaluates truthy, e.g. "window.__probeResult !== \'PENDING\'". Re-evaluated from the MCP side on an interval - do not use await/promises; kick async work off in a prior step, store its result in a global, and wait on the global here.'),
+    ms: z.number().int().positive().max(300000).optional().describe('Fixed sleep in milliseconds. Last resort - prefer selector/expression, which return as soon as the condition holds and fail loudly on timeout instead of silently waiting too little (or too long).'),
+    timeoutMs: z.number().int().positive().max(300000).optional().describe('Give up after this many ms (default: 15000). On timeout the step fails (isError) - in a sequence that stops the run, same as any other failed step.'),
+    pollIntervalMs: z.number().int().min(25).max(5000).optional().describe('Interval between condition checks in ms (default: 100)'),
+    connectionReason: z.string().optional().describe('Connection reference (required for selector/selectorGone/expression; not used for ms). In a sequence the run-level connection is injected automatically, like every other step.'),
+}).strict();
+const DEFAULT_TIMEOUT_MS = 15000;
+const DEFAULT_POLL_INTERVAL_MS = 100;
+/**
+ * Build a self-contained synchronous in-page expression that evaluates to
+ * true when an element matching `selector` exists. Extended selectors
+ * (:has-text etc.) are compiled to an inline text-match - no element marking,
+ * so nothing is lost when the document is replaced between polls.
+ */
+export function buildPresencePredicate(selector) {
+    if (!isExtendedSelector(selector)) {
+        return `!!document.querySelector(${JSON.stringify(selector)})`;
+    }
+    const parsed = parseExtendedSelector(selector);
+    if ('error' in parsed) {
+        return { error: parsed.error };
+    }
+    const { baseSelector, textMatch } = parsed;
+    if (!textMatch) {
+        return `!!document.querySelector(${JSON.stringify(baseSelector)})`;
+    }
+    // Matching semantics identical to resolveSelector(): textContent,
+    // aria-label and title; case-insensitive partial for has-text, exact for
+    // text/text-is.
+    return `(() => {
+    const els = document.querySelectorAll(${JSON.stringify(baseSelector)});
+    const matchText = ${JSON.stringify(textMatch.value)};
+    const partial = ${JSON.stringify(textMatch.type === 'has-text')};
+    for (const el of els) {
+      const tc = (el.textContent || '').trim();
+      const al = el.getAttribute('aria-label') || '';
+      const ti = el.getAttribute('title') || '';
+      if (partial) {
+        if ([tc, al, ti].filter(Boolean).join(' ').toLowerCase().includes(matchText.toLowerCase())) return true;
+      } else if (tc === matchText || al === matchText || ti === matchText) {
+        return true;
+      }
+    }
+    return false;
+  })()`;
+}
+/** Errors that mean the selector itself is bad - retrying cannot help. */
+function isSelectorSyntaxError(message) {
+    return /is not a valid selector|Failed to execute 'querySelector/i.test(message);
+}
+export function createWaitTools(resolveConnectionFromReason) {
+    return {
+        wait: createTool('Wait as a sequence step - the primitive for "the previous step kicked off async work". Exactly one of: selector (element appears), selectorGone (element disappears), expression (synchronous JS predicate polls truthy), ms (fixed sleep, last resort). Condition forms poll from the MCP side, so they survive navigations mid-wait and never depend on in-page timers or promises; on timeout the step fails cleanly instead of hanging.', waitSchema, 
+        // abortSignal: in a sequence this is the RUN's signal - a long wait is
+        // the most cancellable thing a run does, so `replay cancel` must
+        // interrupt it mid-poll instead of letting it run out its own
+        // timeoutMs. On abort the handler THROWS an abort-shaped error (never
+        // returns an isError response); the executor classifies it.
+        async (args, abortSignal) => {
+            const { selector, selectorGone, expression, ms, connectionReason } = args;
+            const timeoutMs = args.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const pollIntervalMs = args.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const forms = [
+                selector !== undefined ? 'selector' : null,
+                selectorGone !== undefined ? 'selectorGone' : null,
+                expression !== undefined ? 'expression' : null,
+                ms !== undefined ? 'ms' : null,
+            ].filter(Boolean);
+            if (forms.length !== 1) {
+                return createErrorResponse('WAIT_INVALID_ARGS', {
+                    message: forms.length === 0
+                        ? 'Provide exactly one of: selector, selectorGone, expression, ms.'
+                        : `Provide exactly one of: selector, selectorGone, expression, ms - got ${forms.join(' + ')}.`,
+                });
+            }
+            const form = forms[0];
+            const buildMeta = (satisfied, elapsedMs, polls) => ({
+                tool: 'wait',
+                action: form,
+                timestamp: Date.now(),
+                wait: {
+                    form,
+                    condition: selector ?? selectorGone ?? expression ?? `${ms}ms`,
+                    satisfied,
+                    elapsedMs,
+                    polls,
+                },
+            });
+            // ---- wait({ ms }): plain sleep, no browser involved -----------------
+            if (form === 'ms') {
+                const start = Date.now();
+                await abortableSleep(ms, abortSignal);
+                const response = createSuccessResponse('WAIT_SLEEP_COMPLETE', { ms: ms });
+                return { ...response, _meta: buildMeta(true, Date.now() - start, 0) };
+            }
+            // ---- condition forms: resolve connection, then poll -----------------
+            if (!connectionReason) {
+                return createErrorResponse('WAIT_INVALID_ARGS', {
+                    message: `wait({ ${form} }) requires a connectionReason (the reference from launchChrome/connectDebugger).`,
+                });
+            }
+            const resolved = await resolveConnectionFromReason(connectionReason);
+            if (!resolved) {
+                return createErrorResponse('CONNECTION_NOT_FOUND', {
+                    message: `No connection found for reference "${connectionReason}". Use launchChrome first, or listConnections to see active references.`,
+                });
+            }
+            const cdpManager = resolved.cdpManager;
+            if (!cdpManager?.isConnected?.()) {
+                return createErrorResponse('DEBUGGER_NOT_CONNECTED');
+            }
+            // Selector forms are DOM-only; expression waits are equally valid
+            // against a Node target (wait for a global to flip in a Node app).
+            if (form !== 'expression' && cdpManager.getRuntimeType?.() === 'node') {
+                return createErrorResponse('NODEJS_NOT_SUPPORTED', { feature: `wait.${form}` });
+            }
+            let predicate;
+            if (form === 'expression') {
+                // Trailing newline protects against a `//` comment swallowing the parenthesis.
+                predicate = `!!(${expression}\n)`;
+            }
+            else {
+                const built = buildPresencePredicate((selector ?? selectorGone));
+                if (typeof built !== 'string') {
+                    return createErrorResponse('WAIT_INVALID_ARGS', {
+                        message: `Invalid selector "${selector ?? selectorGone}": ${built.error}`,
+                    });
+                }
+                predicate = form === 'selectorGone' ? `!(${built})` : built;
+            }
+            const conditionLabel = form === 'selector' ? `element "${selector}" to appear`
+                : form === 'selectorGone' ? `element "${selectorGone}" to disappear`
+                    : `expression to be truthy: ${expression}`;
+            const start = Date.now();
+            let polls = 0;
+            let lastError;
+            while (true) {
+                // Cancelled (e.g. `replay cancel` aborting the run) - stop polling
+                // NOW, not at this wait's own timeoutMs.
+                throwIfAborted(abortSignal);
+                // A paused debugger stops the event loop: the DOM cannot change and
+                // no predicate can flip. Burn no time - fail fast with the reason.
+                if (cdpManager.isPaused?.()) {
+                    return {
+                        ...createErrorResponse('WAIT_DEBUGGER_PAUSED', {
+                            condition: conditionLabel,
+                            connectionReason,
+                        }),
+                        _meta: buildMeta(false, Date.now() - start, polls),
+                    };
+                }
+                polls++;
+                try {
+                    const detailed = await cdpManager.evaluateExpressionDetailed(predicate, undefined, false, // expandObjects - predicate result is a boolean
+                    1, { awaitPromise: false, captureRaw: true });
+                    if (detailed.rawCaptured ? detailed.rawValue === true : detailed.formatted === 'true') {
+                        const elapsedMs = Date.now() - start;
+                        const response = createSuccessResponse('WAIT_CONDITION_MET', {
+                            condition: conditionLabel,
+                            elapsedMs,
+                            polls,
+                        });
+                        return { ...response, _meta: buildMeta(true, elapsedMs, polls) };
+                    }
+                    lastError = undefined; // predicate evaluated cleanly, just false
+                }
+                catch (err) {
+                    // An abort is a cancellation, not an evaluation error - rethrow
+                    // it or the loop below would swallow the user's cancel and keep
+                    // polling until this wait's own timeoutMs.
+                    if (isAbortError(err))
+                        throw err;
+                    // Evaluation errors are expected mid-wait (execution context
+                    // destroyed by a navigation; a global that does not exist yet).
+                    // Swallow and keep polling - but keep the last one for the
+                    // timeout message, and fail fast when the selector itself is
+                    // syntactically invalid (no amount of polling fixes that).
+                    lastError = err?.message || String(err);
+                    if (form !== 'expression' && lastError && isSelectorSyntaxError(lastError)) {
+                        return {
+                            ...createErrorResponse('WAIT_INVALID_ARGS', {
+                                message: `Invalid selector "${selector ?? selectorGone}": ${lastError}`,
+                            }),
+                            _meta: buildMeta(false, Date.now() - start, polls),
+                        };
+                    }
+                }
+                const elapsed = Date.now() - start;
+                if (elapsed + pollIntervalMs > timeoutMs) {
+                    return {
+                        ...createErrorResponse('WAIT_TIMEOUT', {
+                            condition: conditionLabel,
+                            timeoutMs,
+                            polls,
+                            lastError: lastError ? `\n**Last evaluation error:** ${lastError}` : '',
+                        }),
+                        _meta: buildMeta(false, elapsed, polls),
+                    };
+                }
+                await abortableSleep(pollIntervalMs, abortSignal);
+            }
+        }),
+    };
+}
+//# sourceMappingURL=wait-tools.js.map

package/build/tools/wait-tools.js.map

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

package/build/tools/wait-tools.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unit tests for the wait tool (bug-016): the sequence-step wait primitive.
+ * Real-browser behaviour (navigation mid-wait, predicate flip) is verified
+ * manually against Chrome; these tests cover the pure logic - form
+ * validation, predicate compilation, polling/timeout behaviour and the
+ * paused-debugger fail-fast - against a fake CDP manager.
+ */
+export {};
+//# sourceMappingURL=wait-tools.test.d.ts.map

package/build/tools/wait-tools.test.d.ts.map

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

package/build/tools/wait-tools.test.js

@@ -0,0 +1,193 @@
+/**
+ * Unit tests for the wait tool (bug-016): the sequence-step wait primitive.
+ * Real-browser behaviour (navigation mid-wait, predicate flip) is verified
+ * manually against Chrome; these tests cover the pure logic - form
+ * validation, predicate compilation, polling/timeout behaviour and the
+ * paused-debugger fail-fast - against a fake CDP manager.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { createWaitTools, buildPresencePredicate } from './wait-tools.js';
+import { commandNeedsBrowserConnection, TOOLS_ACCEPTING_CONNECTION, TOOLS_NEEDING_CONNECTION, } from './replay-executor.js';
+function makeCdpManager(overrides = {}) {
+    return {
+        isPaused: () => false,
+        isConnected: () => true,
+        getRuntimeType: () => 'browser',
+        evaluateExpressionDetailed: vi.fn(async () => ({ formatted: 'true', rawValue: true, rawCaptured: true })),
+        ...overrides,
+    };
+}
+function makeWait(cdpManager = makeCdpManager()) {
+    const resolve = vi.fn(async () => ({
+        connection: { port: 9222 },
+        cdpManager,
+        puppeteerManager: null,
+    }));
+    const { wait } = createWaitTools(resolve);
+    return { wait, resolve, cdpManager };
+}
+describe('buildPresencePredicate', () => {
+    it('compiles a plain CSS selector to a querySelector check', () => {
+        expect(buildPresencePredicate('#app .btn')).toBe('!!document.querySelector("#app .btn")');
+    });
+    it('compiles :has-text() to an inline synchronous text match (no element marking)', () => {
+        const built = buildPresencePredicate('button:has-text("Join")');
+        expect(typeof built).toBe('string');
+        const expr = built;
+        expect(expr).toContain('querySelectorAll("button")');
+        expect(expr).toContain('"Join"');
+        // Must be self-contained: no data-attribute marking that a navigation would lose
+        expect(expr).not.toContain('data-cdp-selector-match');
+    });
+    it('reports invalid extended selector syntax', () => {
+        const built = buildPresencePredicate('button:has-text(unquoted)');
+        expect(built).toHaveProperty('error');
+    });
+});
+describe('wait form validation', () => {
+    it('rejects zero forms', async () => {
+        const { wait } = makeWait();
+        const result = await wait.handler({});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('exactly one');
+    });
+    it('rejects two forms at once', async () => {
+        const { wait } = makeWait();
+        const result = await wait.handler({ selector: '#a', ms: 100 });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('selector + ms');
+    });
+    it('requires connectionReason for condition forms', async () => {
+        const { wait } = makeWait();
+        const result = await wait.handler({ selector: '#a' });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('connectionReason');
+    });
+});
+describe('wait({ ms })', () => {
+    it('sleeps without touching the connection', async () => {
+        const { wait, resolve } = makeWait();
+        const start = Date.now();
+        const result = await wait.handler({ ms: 60 });
+        expect(result.isError).toBeUndefined();
+        expect(Date.now() - start).toBeGreaterThanOrEqual(55);
+        expect(resolve).not.toHaveBeenCalled();
+        expect(result._meta?.wait).toMatchObject({ form: 'ms', satisfied: true, polls: 0 });
+    });
+});
+describe('wait condition polling', () => {
+    it('returns as soon as the predicate flips true', async () => {
+        let calls = 0;
+        const cdp = makeCdpManager({
+            evaluateExpressionDetailed: vi.fn(async () => {
+                calls++;
+                return { formatted: String(calls >= 3), rawValue: calls >= 3, rawCaptured: true };
+            }),
+        });
+        const { wait } = makeWait(cdp);
+        const result = await wait.handler({
+            expression: 'window.__x === 1', connectionReason: 'test', pollIntervalMs: 25,
+        });
+        expect(result.isError).toBeUndefined();
+        expect(calls).toBe(3);
+        expect(result._meta?.wait).toMatchObject({ form: 'expression', satisfied: true, polls: 3 });
+    });
+    it('swallows evaluation errors mid-wait (context destroyed by navigation) and keeps polling', async () => {
+        let calls = 0;
+        const cdp = makeCdpManager({
+            evaluateExpressionDetailed: vi.fn(async () => {
+                calls++;
+                if (calls < 3)
+                    throw new Error('Execution context was destroyed');
+                return { formatted: 'true', rawValue: true, rawCaptured: true };
+            }),
+        });
+        const { wait } = makeWait(cdp);
+        const result = await wait.handler({
+            selector: '#after-nav', connectionReason: 'test', pollIntervalMs: 25,
+        });
+        expect(result.isError).toBeUndefined();
+        expect(calls).toBe(3);
+    });
+    it('times out cleanly with WAIT_TIMEOUT instead of hanging', async () => {
+        const cdp = makeCdpManager({
+            evaluateExpressionDetailed: vi.fn(async () => ({ formatted: 'false', rawValue: false, rawCaptured: true })),
+        });
+        const { wait } = makeWait(cdp);
+        const result = await wait.handler({
+            expression: 'false', connectionReason: 'test', timeoutMs: 120, pollIntervalMs: 25,
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('Timed out after 120ms');
+        expect(result._meta?.wait).toMatchObject({ form: 'expression', satisfied: false });
+    });
+    it('includes the last evaluation error in the timeout message', async () => {
+        const cdp = makeCdpManager({
+            evaluateExpressionDetailed: vi.fn(async () => { throw new Error('myGlobal is not defined'); }),
+        });
+        const { wait } = makeWait(cdp);
+        const result = await wait.handler({
+            expression: 'myGlobal.ready', connectionReason: 'test', timeoutMs: 80, pollIntervalMs: 25,
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('myGlobal is not defined');
+    });
+    it('fails fast while the debugger is paused (nothing can change)', async () => {
+        const evaluate = vi.fn();
+        const cdp = makeCdpManager({ isPaused: () => true, evaluateExpressionDetailed: evaluate });
+        const { wait } = makeWait(cdp);
+        const start = Date.now();
+        const result = await wait.handler({
+            selector: '#x', connectionReason: 'test', timeoutMs: 5000,
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('paused');
+        expect(Date.now() - start).toBeLessThan(1000);
+        expect(evaluate).not.toHaveBeenCalled();
+    });
+    it('fails fast on an invalid CSS selector instead of polling out the timeout', async () => {
+        const cdp = makeCdpManager({
+            evaluateExpressionDetailed: vi.fn(async () => {
+                throw new Error(`'###' is not a valid selector`);
+            }),
+        });
+        const { wait } = makeWait(cdp);
+        const start = Date.now();
+        const result = await wait.handler({
+            selector: '###', connectionReason: 'test', timeoutMs: 10000,
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('not a valid selector');
+        expect(Date.now() - start).toBeLessThan(1000);
+    });
+    it('rejects selector waits against a Node.js target but allows expression waits', async () => {
+        const cdp = makeCdpManager({ getRuntimeType: () => 'node' });
+        const { wait } = makeWait(cdp);
+        const selectorResult = await wait.handler({ selector: '#x', connectionReason: 'node-app' });
+        expect(selectorResult.isError).toBe(true);
+        const exprResult = await wait.handler({ expression: 'true', connectionReason: 'node-app' });
+        expect(exprResult.isError).toBeUndefined();
+    });
+    it('negates the predicate for selectorGone', async () => {
+        const cdp = makeCdpManager();
+        const { wait } = makeWait(cdp);
+        await wait.handler({ selectorGone: '.spinner', connectionReason: 'test' });
+        const predicate = cdp.evaluateExpressionDetailed.mock.calls[0][0];
+        expect(predicate).toBe('!(!!document.querySelector(".spinner"))');
+    });
+});
+describe('executor integration', () => {
+    it('wait is injectable but only browser-bound in its selector forms', () => {
+        expect(TOOLS_ACCEPTING_CONNECTION).toContain('wait');
+        // ms sleeps and expression waits must never drag a Chrome auto-launch in
+        expect(TOOLS_NEEDING_CONNECTION).not.toContain('wait');
+        expect(commandNeedsBrowserConnection({ tool: 'wait', params: { ms: 500 } })).toBe(false);
+        expect(commandNeedsBrowserConnection({ tool: 'wait', params: { expression: 'x' } })).toBe(false);
+        expect(commandNeedsBrowserConnection({ tool: 'wait', params: { selector: '#a' } })).toBe(true);
+        expect(commandNeedsBrowserConnection({ tool: 'wait', params: { selectorGone: '#a' } })).toBe(true);
+        // unchanged for everything else
+        expect(commandNeedsBrowserConnection({ tool: 'navigate', params: {} })).toBe(true);
+        expect(commandNeedsBrowserConnection({ tool: 'inspect', params: {} })).toBe(false);
+    });
+});
+//# sourceMappingURL=wait-tools.test.js.map

package/build/tools/wait-tools.test.js.map

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

package/build/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Type definitions for the CDP debugger
+ */
+/**
+ * Executes a registered tool by name (the replay/issues subsystems' way of
+ * calling tools internally). The optional signal is forwarded to the tool's
+ * handler; handlers that honour it THROW an abort-shaped error (see
+ * utils/abort.ts isAbortError) rather than returning an isError response.
+ * One shared type so the next parameter is not added in twelve places again.
+ */
+export type ExecuteToolCall = (toolName: string, params: Record<string, any>, abortSignal?: AbortSignal) => Promise<any>;
+export interface BreakpointInfo {
+    breakpointId: string;
+    location: {
+        scriptId: string;
+        lineNumber: number;
+        columnNumber?: number;
+    };
+    originalLocation?: {
+        url: string;
+        lineNumber: number;
+        columnNumber?: number;
+    };
+    isLogpoint?: boolean;
+    /**
+     * Status of the breakpoint:
+     * - 'resolved': Breakpoint is set and bound to a loaded script
+     * - 'pending': Breakpoint is set but script hasn't loaded yet (will activate when script loads)
+     */
+    status?: 'resolved' | 'pending';
+}
+/**
+ * DOM Breakpoint types (from CDP DOMDebugger.DOMBreakpointType)
+ */
+export type DOMBreakpointType = 'subtree-modified' | 'attribute-modified' | 'node-removed';
+/**
+ * DOM Breakpoint info - pauses when DOM node is modified
+ */
+export interface DOMBreakpointInfo {
+    breakpointId: string;
+    type: 'dom';
+    nodeId: number;
+    domBreakpointType: DOMBreakpointType;
+    selector: string;
+}
+/**
+ * Event Listener Breakpoint info - pauses when event fires
+ */
+export interface EventListenerBreakpointInfo {
+    breakpointId: string;
+    type: 'event';
+    eventName: string;
+    targetName?: string;
+}
+/**
+ * XHR/Fetch Breakpoint info - pauses when network request matches URL
+ */
+export interface XHRBreakpointInfo {
+    breakpointId: string;
+    type: 'xhr';
+    urlPattern: string;
+}
+export interface CallFrame {
+    callFrameId: string;
+    functionName: string;
+    location: {
+        scriptId: string;
+        lineNumber: number;
+        columnNumber: number;
+    };
+    url: string;
+    scopeChain: Scope[];
+}
+export interface Scope {
+    type: string;
+    object: {
+        objectId: string;
+        type: string;
+        className?: string;
+    };
+    name?: string;
+}
+export interface Variable {
+    name: string;
+    value: string;
+    type: string;
+}
+export type RuntimeType = 'chrome' | 'node' | 'unknown';
+export interface DebuggerState {
+    connected: boolean;
+    paused: boolean;
+    currentCallFrames?: CallFrame[];
+    breakpoints: Map<string, BreakpointInfo>;
+    runtimeType?: RuntimeType;
+}
+/**
+ * CDP Runtime.consoleAPICalled event parameters
+ */
+export interface CDPConsoleMessage {
+    type: 'log' | 'debug' | 'info' | 'error' | 'warning' | 'dir' | 'dirxml' | 'table' | 'trace' | 'clear' | 'startGroup' | 'startGroupCollapsed' | 'endGroup' | 'assert' | 'profile' | 'profileEnd' | 'count' | 'timeEnd';
+    args: Array<{
+        type: string;
+        subtype?: string;
+        className?: string;
+        value?: any;
+        description?: string;
+        objectId?: string;
+        unserializableValue?: string;
+        preview?: {
+            type: string;
+            description?: string;
+            overflow?: boolean;
+            properties?: Array<{
+                name: string;
+                type: string;
+                value?: string;
+            }>;
+        };
+    }>;
+    executionContextId: number;
+    timestamp: number;
+    stackTrace?: {
+        callFrames: Array<{
+            functionName: string;
+            scriptId: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+        }>;
+    };
+}
+export type ConsoleMessageCallback = (message: CDPConsoleMessage) => void;
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the CDP debugger
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}