browser-debugger-cli 0.5.1 → 0.6.1

package/dist/ipc/client.d.ts

@@ -1,124 +1,133 @@
 /**
- * IPC Client - Minimal JSONL handshake MVP
+ * IPC Client
  *
- * Connects to the daemon's Unix domain socket and performs handshake.
+ * Public API for communicating with the daemon via Unix socket.
+ * Provides high-level functions for session lifecycle and queries.
  */
-import type { ClientResponse } from '../ipc/commands.js';
-import type { HandshakeResponse, PeekResponse, StartSessionResponse, StatusResponse, StopSessionResponse } from '../ipc/types.js';
-import type { TelemetryType } from '../types.js';
+import type { ClientResponse } from './protocol/index.js';
+import type { HandshakeResponse, PeekResponse, SessionOptions, StartSessionResponse, StatusResponse, StopSessionResponse } from './session/index.js';
 /**
  * Connect to the daemon and perform handshake.
+ * Verifies daemon is running and ready to accept commands.
  *
- * @returns Handshake response from daemon
- * @throws Error if connection fails or handshake times out
+ * @returns Handshake response with connection status
+ * @throws Error if connection fails or times out
+ *
+ * @example
+ * ```typescript
+ * const response = await connectToDaemon();
+ * if (response.status === 'ok') {
+ *   console.log('Connected:', response.message);
+ * }
+ * ```
  */
 export declare function connectToDaemon(): Promise<HandshakeResponse>;
 /**
  * Request status information from the daemon.
+ * Returns daemon state, session metadata, and activity metrics.
+ *
+ * @returns Status response with daemon and session information
+ * @throws Error if connection fails or times out
  *
- * @returns Status response with daemon and session metadata
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getStatus();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Daemon PID:', response.data.daemonPid);
+ *   console.log('Session active:', !!response.data.sessionPid);
+ * }
+ * ```
  */
 export declare function getStatus(): Promise<StatusResponse>;
 /**
  * Request preview data from the daemon.
+ * Returns snapshot of collected telemetry without stopping session.
+ *
+ * @returns Peek response with preview data
+ * @throws Error if connection fails, times out, or no active session
  *
- * @returns Peek response with session preview data
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getPeek();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Network requests:', response.data.preview.data.network?.length);
+ *   console.log('Console messages:', response.data.preview.data.console?.length);
+ * }
+ * ```
  */
 export declare function getPeek(): Promise<PeekResponse>;
 /**
  * Request daemon to start a new browser session.
+ * Launches Chrome, establishes CDP connection, and begins telemetry collection.
  *
  * @param url - Target URL to navigate to
  * @param options - Session configuration options
- * @returns Start session response with worker and Chrome metadata
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function startSession(url: string, options?: {
-    port?: number;
-    timeout?: number;
-    telemetry?: TelemetryType[];
-    includeAll?: boolean;
-    userDataDir?: string;
-    maxBodySize?: number;
-    headless?: boolean;
-    chromeWsUrl?: string;
-}): Promise<StartSessionResponse>;
-/**
- * Request session stop from the daemon.
+ * @returns Start session response with worker and Chrome PIDs
+ * @throws Error if connection fails, session already running, or Chrome launch fails
  *
- * @returns Stop session response with success/error status
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await startSession('http://localhost:3000', {
+ *   timeout: 30,
+ *   headless: true,
+ *   maxBodySize: 10
+ * });
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Session started, worker PID:', response.data.workerPid);
+ * }
+ * ```
  */
-export declare function stopSession(): Promise<StopSessionResponse>;
+export declare function startSession(url: string, options?: SessionOptions): Promise<StartSessionResponse>;
 /**
- * Query DOM elements by CSS selector via the daemon's worker.
- *
- * @param selector - CSS selector to query
- * @returns DOM query response with matched elements
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function queryDOM(selector: string): Promise<ClientResponse<'dom_query'>>;
-/**
- * Highlight DOM elements in the browser via the daemon's worker.
+ * Request session stop from the daemon.
+ * Stops telemetry collection, closes Chrome, and writes output file.
  *
- * @param options - Highlight options (selector, index, nodeId, color, etc.)
- * @returns DOM highlight response with highlighted node information
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function highlightDOM(options: {
-    selector?: string;
-    index?: number;
-    nodeId?: number;
-    first?: boolean;
-    nth?: number;
-    color?: string;
-    opacity?: number;
-}): Promise<ClientResponse<'dom_highlight'>>;
-/**
- * Get full HTML and attributes for DOM elements via the daemon's worker.
+ * @returns Stop session response with termination status
+ * @throws Error if connection fails, times out, or no active session
  *
- * @param options - Get options (selector, index, nodeId, all, nth)
- * @returns DOM get response with node information
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await stopSession();
+ * if (response.status === 'ok') {
+ *   console.log('Session stopped:', response.message);
+ * }
+ * ```
  */
-export declare function getDOM(options: {
-    selector?: string;
-    index?: number;
-    nodeId?: number;
-    all?: boolean;
-    nth?: number;
-}): Promise<ClientResponse<'dom_get'>>;
+export declare function stopSession(): Promise<StopSessionResponse>;
 /**
- * Capture page screenshot via the daemon's worker.
+ * Get details for a specific network request or console message.
+ * Retrieves full data (headers, body, stack trace) for a telemetry item.
  *
- * @param path - Output file path (absolute path)
- * @param options - Screenshot options (format, quality, fullPage)
- * @returns Screenshot response with metadata (path, dimensions, size)
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export declare function captureScreenshot(path: string, options?: {
-    format?: 'png' | 'jpeg';
-    quality?: number;
-    fullPage?: boolean;
-}): Promise<ClientResponse<'dom_screenshot'>>;
-/**
- * Get details for a specific network request or console message via the daemon's worker.
+ * @param type - Type of item to retrieve ('network' or 'console')
+ * @param id - Unique identifier of the item
+ * @returns Response with full item details
+ * @throws Error if connection fails or item not found
  *
- * @param type - Type of item: 'network' or 'console'
- * @param id - Request ID for network, index for console
- * @returns Worker details response with full object (including bodies/args)
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getDetails('network', 'req-123');
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Full request:', response.data.item);
+ * }
+ * ```
  */
 export declare function getDetails(type: 'network' | 'console', id: string): Promise<ClientResponse<'worker_details'>>;
 /**
  * Execute arbitrary CDP method via the daemon's worker.
+ * Forwards CDP commands to the worker's active CDP connection.
+ *
+ * @param method - CDP method name (e.g., 'Network.getCookies')
+ * @param params - Optional method parameters
+ * @returns Response with CDP method result
+ * @throws Error if connection fails or CDP method fails
  *
- * @param method - CDP method name (e.g., 'Network.getCookies', 'Runtime.evaluate')
- * @param params - CDP method parameters (optional)
- * @returns CDP call response with method result
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await callCDP('Network.getCookies', {});
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Cookies:', response.data.result);
+ * }
+ * ```
  */
 export declare function callCDP(method: string, params?: Record<string, unknown>): Promise<ClientResponse<'cdp_call'>>;
 //# sourceMappingURL=client.d.ts.map

package/dist/ipc/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ipc/client.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAGH,OAAO,KAAK,EAAwC,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,KAAK,EAEV,iBAAiB,EAEjB,YAAY,EAEZ,oBAAoB,EAEpB,cAAc,EAEd,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuGhD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAOlE;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAOzD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAOrD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAOhE;AAsBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAErF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAE3C;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAErC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAS3C;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAE3C;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAErC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ipc/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAiB,cAAc,EAAe,MAAM,qBAAqB,CAAC;AAEtF,OAAO,KAAK,EAEV,iBAAiB,EAEjB,YAAY,EACZ,cAAc,EAEd,oBAAoB,EAEpB,cAAc,EAEd,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAOlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAGzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAGrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAOhE;AA4BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAE3C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAErC"}

package/dist/ipc/client.js

@@ -1,251 +1,180 @@
-/* eslint-disable import/order */
 /**
- * IPC Client - Minimal JSONL handshake MVP
+ * IPC Client
  *
- * Connects to the daemon's Unix domain socket and performs handshake.
+ * Public API for communicating with the daemon via Unix socket.
+ * Provides high-level functions for session lifecycle and queries.
  */
-import { randomUUID } from 'crypto';
-import { connect } from 'net';
-import { getIPCRequestTimeout } from '../constants.js';
-import { getDaemonSocketPath } from '../session/paths.js';
-import { getErrorMessage } from '../ui/errors/index.js';
-import { createLogger } from '../ui/logging/index.js';
-import { filterDefined } from '../utils/objects.js';
-const log = createLogger('client');
-/**
- * Generic IPC request sender that handles connection, timeout, and error handling.
- * Supports both traditional IPC messages (handshake, status, etc.) and command messages (DOM commands).
- *
- * @param request - The IPC request to send (either IPCRequest or ClientRequest<T>)
- * @param requestName - Human-readable name for logging (e.g., 'status', 'peek')
- * @returns Promise that resolves with the response
- */
-async function sendRequest(request, requestName) {
-    const socketPath = getDaemonSocketPath();
-    return new Promise((resolve, reject) => {
-        const socket = connect(socketPath);
-        let buffer = '';
-        let resolved = false;
-        // Set request timeout
-        const timeoutMs = getIPCRequestTimeout();
-        const timeout = setTimeout(() => {
-            if (!resolved) {
-                resolved = true;
-                socket.destroy();
-                reject(new Error(`${requestName} request timeout after ${timeoutMs / 1000}s`));
-            }
-        }, timeoutMs);
-        socket.on('connect', () => {
-            log.debug(`Connected to daemon for ${requestName} request`);
-            socket.write(JSON.stringify(request) + '\n');
-            log.debug(`${requestName} request sent`);
-        });
-        socket.on('data', (chunk) => {
-            buffer += chunk.toString('utf-8');
-            // Process complete JSONL frames
-            const lines = buffer.split('\n');
-            buffer = lines.pop() ?? '';
-            for (const line of lines) {
-                if (line.trim() && !resolved) {
-                    try {
-                        const response = JSON.parse(line);
-                        log.debug(`${requestName} response received`);
-                        resolved = true;
-                        clearTimeout(timeout);
-                        socket.destroy();
-                        resolve(response);
-                    }
-                    catch (error) {
-                        if (!resolved) {
-                            resolved = true;
-                            clearTimeout(timeout);
-                            socket.destroy();
-                            reject(new Error(`Failed to parse ${requestName} response: ${getErrorMessage(error)}`));
-                        }
-                    }
-                }
-            }
-        });
-        socket.on('error', (err) => {
-            if (!resolved) {
-                resolved = true;
-                clearTimeout(timeout);
-                const fullMessage = [
-                    `IPC ${requestName} connection error`,
-                    `Socket: ${socketPath}`,
-                    `Details: ${err.message}`,
-                ].join(' | ');
-                reject(new Error(fullMessage));
-            }
-        });
-        socket.on('end', () => {
-            if (!resolved) {
-                resolved = true;
-                clearTimeout(timeout);
-                reject(new Error(`Connection closed before ${requestName} response received`));
-            }
-        });
-    });
-}
+import { sendRequest } from './transport/index.js';
+import { withSession } from './utils/index.js';
 /**
  * Connect to the daemon and perform handshake.
+ * Verifies daemon is running and ready to accept commands.
+ *
+ * @returns Handshake response with connection status
+ * @throws Error if connection fails or times out
  *
- * @returns Handshake response from daemon
- * @throws Error if connection fails or handshake times out
+ * @example
+ * ```typescript
+ * const response = await connectToDaemon();
+ * if (response.status === 'ok') {
+ *   console.log('Connected:', response.message);
+ * }
+ * ```
  */
 export async function connectToDaemon() {
-    const request = {
-        type: 'handshake_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'handshake');
+    const request = withSession({ type: 'handshake_request' });
+    return sendRequest(request, 'handshake', 'handshake_response');
 }
 /**
  * Request status information from the daemon.
+ * Returns daemon state, session metadata, and activity metrics.
+ *
+ * @returns Status response with daemon and session information
+ * @throws Error if connection fails or times out
  *
- * @returns Status response with daemon and session metadata
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getStatus();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Daemon PID:', response.data.daemonPid);
+ *   console.log('Session active:', !!response.data.sessionPid);
+ * }
+ * ```
  */
 export async function getStatus() {
-    const request = {
-        type: 'status_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'status');
+    const request = withSession({ type: 'status_request' });
+    return sendRequest(request, 'status', 'status_response');
 }
 /**
  * Request preview data from the daemon.
+ * Returns snapshot of collected telemetry without stopping session.
  *
- * @returns Peek response with session preview data
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @returns Peek response with preview data
+ * @throws Error if connection fails, times out, or no active session
+ *
+ * @example
+ * ```typescript
+ * const response = await getPeek();
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Network requests:', response.data.preview.data.network?.length);
+ *   console.log('Console messages:', response.data.preview.data.console?.length);
+ * }
+ * ```
  */
 export async function getPeek() {
-    const request = {
-        type: 'peek_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'peek');
+    const request = withSession({ type: 'peek_request' });
+    return sendRequest(request, 'peek', 'peek_response');
 }
 /**
  * Request daemon to start a new browser session.
+ * Launches Chrome, establishes CDP connection, and begins telemetry collection.
  *
  * @param url - Target URL to navigate to
  * @param options - Session configuration options
- * @returns Start session response with worker and Chrome metadata
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @returns Start session response with worker and Chrome PIDs
+ * @throws Error if connection fails, session already running, or Chrome launch fails
+ *
+ * @example
+ * ```typescript
+ * const response = await startSession('http://localhost:3000', {
+ *   timeout: 30,
+ *   headless: true,
+ *   maxBodySize: 10
+ * });
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Session started, worker PID:', response.data.workerPid);
+ * }
+ * ```
  */
 export async function startSession(url, options) {
-    const request = {
+    const request = withSession({
         type: 'start_session_request',
-        sessionId: randomUUID(),
         url,
-        ...filterDefined({
-            port: options?.port,
-            timeout: options?.timeout,
-            telemetry: options?.telemetry,
-            includeAll: options?.includeAll,
-            userDataDir: options?.userDataDir,
-            maxBodySize: options?.maxBodySize,
-            headless: options?.headless,
-            chromeWsUrl: options?.chromeWsUrl,
+        ...(options && {
+            port: options.port,
+            timeout: options.timeout,
+            telemetry: options.telemetry,
+            includeAll: options.includeAll,
+            userDataDir: options.userDataDir,
+            maxBodySize: options.maxBodySize,
+            headless: options.headless,
+            chromeWsUrl: options.chromeWsUrl,
         }),
-    };
-    return sendRequest(request, 'start session');
+    });
+    return sendRequest(request, 'start session', 'start_session_response');
 }
 /**
  * Request session stop from the daemon.
+ * Stops telemetry collection, closes Chrome, and writes output file.
+ *
+ * @returns Stop session response with termination status
+ * @throws Error if connection fails, times out, or no active session
  *
- * @returns Stop session response with success/error status
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await stopSession();
+ * if (response.status === 'ok') {
+ *   console.log('Session stopped:', response.message);
+ * }
+ * ```
  */
 export async function stopSession() {
-    const request = {
-        type: 'stop_session_request',
-        sessionId: randomUUID(),
-    };
-    return sendRequest(request, 'stop session');
+    const request = withSession({ type: 'stop_session_request' });
+    return sendRequest(request, 'stop session', 'stop_session_response');
 }
 /**
- * Generic command sender - works for any registered command in the COMMANDS registry.
+ * Send a command to the worker process.
+ * Internal helper for worker commands (details, CDP calls).
  *
- * @param commandName - Name of the command from the COMMANDS registry
- * @param params - Command parameters matching the command's request schema
- * @returns Promise that resolves with the command response
+ * @param commandName - Name of the command to send
+ * @param params - Command parameters (without type field)
+ * @returns Command response from worker
+ * @throws Error if connection fails or command execution fails
  */
 async function sendCommand(commandName, params) {
     const request = {
-        type: `${commandName}_request`,
-        sessionId: randomUUID(),
         ...params,
+        type: `${commandName}_request`,
+        sessionId: withSession({ type: '' }).sessionId,
     };
-    return sendRequest(request, commandName);
-}
-/**
- * Query DOM elements by CSS selector via the daemon's worker.
- *
- * @param selector - CSS selector to query
- * @returns DOM query response with matched elements
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export async function queryDOM(selector) {
-    return sendCommand('dom_query', { selector });
-}
-/**
- * Highlight DOM elements in the browser via the daemon's worker.
- *
- * @param options - Highlight options (selector, index, nodeId, color, etc.)
- * @returns DOM highlight response with highlighted node information
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export async function highlightDOM(options) {
-    return sendCommand('dom_highlight', options);
+    return sendRequest(request, commandName, `${commandName}_response`);
 }
 /**
- * Get full HTML and attributes for DOM elements via the daemon's worker.
+ * Get details for a specific network request or console message.
+ * Retrieves full data (headers, body, stack trace) for a telemetry item.
  *
- * @param options - Get options (selector, index, nodeId, all, nth)
- * @returns DOM get response with node information
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export async function getDOM(options) {
-    return sendCommand('dom_get', options);
-}
-/**
- * Capture page screenshot via the daemon's worker.
- *
- * @param path - Output file path (absolute path)
- * @param options - Screenshot options (format, quality, fullPage)
- * @returns Screenshot response with metadata (path, dimensions, size)
- * @throws Error if connection fails, daemon is not running, or request times out
- */
-export async function captureScreenshot(path, options) {
-    return sendCommand('dom_screenshot', {
-        path,
-        ...filterDefined({
-            format: options?.format,
-            quality: options?.quality,
-            fullPage: options?.fullPage,
-        }),
-    });
-}
-/**
- * Get details for a specific network request or console message via the daemon's worker.
+ * @param type - Type of item to retrieve ('network' or 'console')
+ * @param id - Unique identifier of the item
+ * @returns Response with full item details
+ * @throws Error if connection fails or item not found
  *
- * @param type - Type of item: 'network' or 'console'
- * @param id - Request ID for network, index for console
- * @returns Worker details response with full object (including bodies/args)
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await getDetails('network', 'req-123');
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Full request:', response.data.item);
+ * }
+ * ```
  */
 export async function getDetails(type, id) {
     return sendCommand('worker_details', { itemType: type, id });
 }
 /**
  * Execute arbitrary CDP method via the daemon's worker.
+ * Forwards CDP commands to the worker's active CDP connection.
+ *
+ * @param method - CDP method name (e.g., 'Network.getCookies')
+ * @param params - Optional method parameters
+ * @returns Response with CDP method result
+ * @throws Error if connection fails or CDP method fails
  *
- * @param method - CDP method name (e.g., 'Network.getCookies', 'Runtime.evaluate')
- * @param params - CDP method parameters (optional)
- * @returns CDP call response with method result
- * @throws Error if connection fails, daemon is not running, or request times out
+ * @example
+ * ```typescript
+ * const response = await callCDP('Network.getCookies', {});
+ * if (response.status === 'ok' && response.data) {
+ *   console.log('Cookies:', response.data.result);
+ * }
+ * ```
  */
 export async function callCDP(method, params) {
     return sendCommand('cdp_call', { method, ...(params && { params }) });

package/dist/ipc/client.js.map

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

package/dist/ipc/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * IPC Module
+ *
+ * Public API for inter-process communication between CLI, daemon, and worker.
+ *
+ * Organized into layers:
+ * - Client API (high-level functions for CLI commands)
+ * - Session messages (lifecycle and query types)
+ * - Protocol (worker command schemas and type guards)
+ * - Transport (low-level socket communication)
+ * - Validation (response validation utilities)
+ */
+export * from './client.js';
+export * from './session/index.js';
+export * from './protocol/index.js';
+export { validateIPCResponse } from './utils/responseValidator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ipc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ipc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC"}