browser-debugger-cli 0.7.1 → 0.8.0

package/dist/ipc/protocol/guards.d.ts

@@ -12,7 +12,7 @@ import { type CommandName } from './commands.js';
  *
  * @example
  * ```typescript
- * isCommandRequest('worker_peek_request') // true
+ * isCommandRequest('session_peek_request') // true
  * isCommandRequest('status_request')      // false
  * ```
  */
@@ -25,7 +25,7 @@ export declare function isCommandRequest(type: string): type is `${CommandName}_
  *
  * @example
  * ```typescript
- * isCommandResponse('worker_peek_response') // true
+ * isCommandResponse('session_peek_response') // true
  * isCommandResponse('status_response')      // false
  * ```
  */
@@ -38,8 +38,8 @@ export declare function isCommandResponse(type: string): type is `${CommandName}
  *
  * @example
  * ```typescript
- * getCommandName('worker_peek_request')  // 'worker_peek'
- * getCommandName('worker_peek_response') // 'worker_peek'
+ * getCommandName('session_peek_request')  // 'session_peek'
+ * getCommandName('session_peek_response') // 'session_peek'
  * getCommandName('status_request')       // null
  * ```
  */

package/dist/ipc/protocol/guards.js

@@ -12,7 +12,7 @@ import { COMMANDS } from './commands.js';
  *
  * @example
  * ```typescript
- * isCommandRequest('worker_peek_request') // true
+ * isCommandRequest('session_peek_request') // true
  * isCommandRequest('status_request')      // false
  * ```
  */
@@ -30,7 +30,7 @@ export function isCommandRequest(type) {
  *
  * @example
  * ```typescript
- * isCommandResponse('worker_peek_response') // true
+ * isCommandResponse('session_peek_response') // true
  * isCommandResponse('status_response')      // false
  * ```
  */
@@ -48,8 +48,8 @@ export function isCommandResponse(type) {
  *
  * @example
  * ```typescript
- * getCommandName('worker_peek_request')  // 'worker_peek'
- * getCommandName('worker_peek_response') // 'worker_peek'
+ * getCommandName('session_peek_request')  // 'session_peek'
+ * getCommandName('session_peek_response') // 'session_peek'
  * getCommandName('status_request')       // null
  * ```
  */

package/dist/ipc/protocol/messages.d.ts

@@ -2,28 +2,9 @@
  * IPC Message Type Constructors
  *
  * Generic types for constructing strongly-typed request/response messages
- * for both worker communication and client-daemon communication.
+ * for client-daemon communication.
  */
 import type { COMMANDS, CommandName } from './commands.js';
-/**
- * Worker request message (daemon → worker).
- * Includes requestId for correlation.
- */
-export type WorkerRequest<T extends CommandName> = {
-    type: `${T}_request`;
-    requestId: string;
-} & Omit<(typeof COMMANDS)[T]['requestSchema'], 'type' | 'requestId'>;
-/**
- * Worker response message (worker → daemon).
- * Includes success flag and optional error.
- */
-export type WorkerResponse<T extends CommandName> = {
-    type: `${T}_response`;
-    requestId: string;
-    success: boolean;
-    data?: (typeof COMMANDS)[T]['responseSchema'];
-    error?: string;
-};
 /**
  * Client request message (CLI → daemon).
  * Includes sessionId for correlation.
@@ -34,7 +15,10 @@ export type ClientRequest<T extends CommandName> = {
 } & Omit<(typeof COMMANDS)[T]['requestSchema'], 'type' | 'sessionId'>;
 /**
  * Client response message (daemon → CLI).
- * Uses status instead of success for consistency with session messages.
+ *
+ * On failure, semantic `exitCode` and `suggestion` from a `CommandError` are
+ * preserved end-to-end so CLI-side handlers can stop guessing with hardcoded
+ * fallback codes.
  */
 export type ClientResponse<T extends CommandName> = {
     type: `${T}_response`;
@@ -42,19 +26,11 @@ export type ClientResponse<T extends CommandName> = {
     status: 'ok' | 'error';
     data?: (typeof COMMANDS)[T]['responseSchema'];
     error?: string;
+    /** Semantic exit code forwarded from the handler (present on failure). */
+    exitCode?: number;
+    /** Recovery suggestion forwarded from the handler (present on failure). */
+    suggestion?: string;
 };
-/**
- * Union of all possible worker request types.
- */
-export type WorkerRequestUnion = {
-    [K in CommandName]: WorkerRequest<K>;
-}[CommandName];
-/**
- * Union of all possible worker response types.
- */
-export type WorkerResponseUnion = {
-    [K in CommandName]: WorkerResponse<K>;
-}[CommandName];
 /**
  * Union of all possible client request types.
  */

package/dist/ipc/protocol/messages.js

@@ -2,7 +2,7 @@
  * IPC Message Type Constructors
  *
  * Generic types for constructing strongly-typed request/response messages
- * for both worker communication and client-daemon communication.
+ * for client-daemon communication.
  */
 export {};
 //# sourceMappingURL=messages.js.map

package/dist/ipc/session/errors.d.ts

@@ -13,8 +13,16 @@ export declare enum IPCErrorCode {
     SESSION_KILL_FAILED = "SESSION_KILL_FAILED",
     /** Attempted to start session when one is already running. */
     SESSION_ALREADY_RUNNING = "SESSION_ALREADY_RUNNING",
-    /** Worker process failed to start. */
-    WORKER_START_FAILED = "WORKER_START_FAILED",
+    /** Active session is attached to a different target than the new request. */
+    SESSION_TARGET_MISMATCH = "SESSION_TARGET_MISMATCH",
+    /** Session (Chrome launch or CDP connection) failed to start. */
+    SESSION_START_FAILED = "SESSION_START_FAILED",
+    /** The start was cancelled: the session was stopped while starting. */
+    SESSION_START_CANCELLED = "SESSION_START_CANCELLED",
+    /** The previous session is still shutting down. */
+    SESSION_SHUTTING_DOWN = "SESSION_SHUTTING_DOWN",
+    /** The start URL could not be loaded (DNS, refused, missing file). */
+    NAVIGATION_FAILED = "NAVIGATION_FAILED",
     /** Chrome browser failed to launch. */
     CHROME_LAUNCH_FAILED = "CHROME_LAUNCH_FAILED",
     /** CDP connection timeout. */

package/dist/ipc/session/errors.js

@@ -14,8 +14,16 @@ export var IPCErrorCode;
     IPCErrorCode["SESSION_KILL_FAILED"] = "SESSION_KILL_FAILED";
     /** Attempted to start session when one is already running. */
     IPCErrorCode["SESSION_ALREADY_RUNNING"] = "SESSION_ALREADY_RUNNING";
-    /** Worker process failed to start. */
-    IPCErrorCode["WORKER_START_FAILED"] = "WORKER_START_FAILED";
+    /** Active session is attached to a different target than the new request. */
+    IPCErrorCode["SESSION_TARGET_MISMATCH"] = "SESSION_TARGET_MISMATCH";
+    /** Session (Chrome launch or CDP connection) failed to start. */
+    IPCErrorCode["SESSION_START_FAILED"] = "SESSION_START_FAILED";
+    /** The start was cancelled: the session was stopped while starting. */
+    IPCErrorCode["SESSION_START_CANCELLED"] = "SESSION_START_CANCELLED";
+    /** The previous session is still shutting down. */
+    IPCErrorCode["SESSION_SHUTTING_DOWN"] = "SESSION_SHUTTING_DOWN";
+    /** The start URL could not be loaded (DNS, refused, missing file). */
+    IPCErrorCode["NAVIGATION_FAILED"] = "NAVIGATION_FAILED";
     /** Chrome browser failed to launch. */
     IPCErrorCode["CHROME_LAUNCH_FAILED"] = "CHROME_LAUNCH_FAILED";
     /** CDP connection timeout. */

package/dist/ipc/session/lifecycle.d.ts

@@ -27,7 +27,12 @@ export interface HandshakeResponse extends IPCMessage {
     message?: string;
 }
 /**
- * Session start options.
+ * Canonical session options — single source of truth for session knobs.
+ *
+ * The CLI and the daemon IPC request (`StartSessionRequest`) both reference
+ * this shape. Adding a new
+ * session option means editing this interface + the Commander flag — nothing
+ * else.
  */
 export interface SessionOptions {
     /** CDP port to use. */
@@ -51,36 +56,21 @@ export interface SessionOptions {
 }
 /**
  * Start session request (client → daemon).
+ *
+ * Derived from `SessionOptions` so a new option flows end-to-end without
+ * redeclaring fields here.
  */
-export interface StartSessionRequest extends IPCMessage {
+export interface StartSessionRequest extends IPCMessage, SessionOptions {
     type: 'start_session_request';
     /** Target URL to navigate to. */
     url: string;
-    /** CDP port to use. */
-    port?: number;
-    /** Auto-stop timeout in seconds. */
-    timeout?: number;
-    /** Telemetry collectors to enable. */
-    telemetry?: TelemetryType[];
-    /** Include all data (disable filtering). */
-    includeAll?: boolean;
-    /** Custom Chrome user data directory. */
-    userDataDir?: string;
-    /** Max response body size in MB. */
-    maxBodySize?: number;
-    /** Launch Chrome in headless mode. */
-    headless?: boolean;
-    /** Connect to existing Chrome instance. */
-    chromeWsUrl?: string;
-    /** Custom Chrome flags (e.g., ['--ignore-certificate-errors']). */
-    chromeFlags?: string[];
 }
 /**
  * Start session response data.
  */
 export interface StartSessionResponseData {
-    /** Worker process ID. */
-    workerPid: number;
+    /** Daemon process ID (the daemon hosts the session). */
+    daemonPid: number;
     /** Chrome process ID. */
     chromePid: number;
     /** CDP port. */
@@ -89,6 +79,12 @@ export interface StartSessionResponseData {
     targetUrl: string;
     /** Target page title. */
     targetTitle?: string;
+    /** HTTP status of the page's main document, when known. */
+    documentStatus?: number;
+    /** True if a stale session was auto-recovered before this one started. */
+    recovered?: boolean;
+    /** Target URL or ws URL of the stale session that was recovered, if recorded. */
+    previousTarget?: string;
 }
 /**
  * Start session response (daemon → client).
@@ -99,6 +95,8 @@ export interface StartSessionResponse extends IPCMessage {
     data?: StartSessionResponseData;
     message?: string;
     errorCode?: IPCErrorCode;
+    /** Exit code when the failure has a more specific one than its error code */
+    exitCode?: number;
     existingSession?: {
         pid: number;
         targetUrl?: string;

package/dist/ipc/session/queries.d.ts

@@ -22,7 +22,7 @@ export interface StatusResponseData {
     daemonStartTime: number;
     /** Unix socket path. */
     socketPath: string;
-    /** Worker process ID (if session active). */
+    /** Session process ID, i.e. the daemon (if session active). */
     sessionPid?: number;
     /** Session metadata (if session active). */
     sessionMetadata?: {
@@ -33,6 +33,8 @@ export interface StatusResponseData {
         targetId?: string;
         webSocketDebuggerUrl?: string;
         activeTelemetry?: TelemetryType[];
+        /** When `--timeout` stops the session (epoch ms) */
+        autoStopAt?: number;
     };
     /** Session activity metrics. */
     activity?: SessionActivity;
@@ -40,6 +42,13 @@ export interface StatusResponseData {
     pageState?: PageState;
     /** Current navigation counter (increments on each page navigation). */
     navigationId?: number;
+    /** Set while the session is shutting down */
+    ending?: boolean;
+    /** Set while `bdg <url>` is starting the session */
+    starting?: {
+        url: string;
+        since: number;
+    };
 }
 /**
  * Status response (daemon → client).
@@ -57,12 +66,16 @@ export interface PeekRequest extends IPCMessage {
     type: 'peek_request';
     /** Number of recent items to return. 0 = all. */
     lastN?: number;
+    /** Return items of one kind only. */
+    only?: 'network' | 'console';
+    /** Include request/response headers in network items. */
+    withHeaders?: boolean;
 }
 /**
  * Peek response data.
  */
 export interface PeekResponseData {
-    /** Worker process ID. */
+    /** Session process ID (the daemon). */
     sessionPid: number;
     /** Preview of collected data. */
     preview: {
@@ -75,10 +88,14 @@ export interface PeekResponseData {
             title: string;
         };
         data: {
-            dom?: unknown;
             network?: unknown[];
             console?: unknown[];
         };
+        totals: {
+            network: number;
+            console: number;
+        };
+        currentNavigationId?: number;
         partial?: boolean;
     };
 }
@@ -101,7 +118,7 @@ export interface HARDataRequest extends IPCMessage {
  * HAR data response data.
  */
 export interface HARDataResponseData {
-    /** Worker process ID. */
+    /** Session process ID (the daemon). */
     sessionPid: number;
     /** Network requests for HAR export. */
     requests: NetworkRequest[];

package/dist/ipc/session/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared Session Types
  *
- * Common types used across session messages and worker commands.
+ * Common types used across session messages and session commands.
  */
 /**
  * Session activity metrics.

package/dist/ipc/session/types.js

@@ -1,7 +1,7 @@
 /**
  * Shared Session Types
  *
- * Common types used across session messages and worker commands.
+ * Common types used across session messages and session commands.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/ipc/transport/IPCError.d.ts

@@ -39,7 +39,7 @@ export declare class IPCConnectionError extends IPCError {
  *
  * @example
  * ```typescript
- * throw new IPCTimeoutError('worker_status', 5000);
+ * throw new IPCTimeoutError('session_status', 5000);
  * ```
  */
 export declare class IPCTimeoutError extends IPCError {
@@ -55,7 +55,7 @@ export declare class IPCTimeoutError extends IPCError {
  *
  * @example
  * ```typescript
- * throw new IPCParseError('worker_peek', 'Unexpected token in JSON');
+ * throw new IPCParseError('session_peek', 'Unexpected token in JSON');
  * ```
  */
 export declare class IPCParseError extends IPCError {
@@ -71,7 +71,7 @@ export declare class IPCParseError extends IPCError {
  *
  * @example
  * ```typescript
- * throw new IPCEarlyCloseError('worker_peek');
+ * throw new IPCEarlyCloseError('session_peek');
  * ```
  */
 export declare class IPCEarlyCloseError extends IPCError {

package/dist/ipc/transport/IPCError.js

@@ -53,7 +53,7 @@ export class IPCConnectionError extends IPCError {
  *
  * @example
  * ```typescript
- * throw new IPCTimeoutError('worker_status', 5000);
+ * throw new IPCTimeoutError('session_status', 5000);
  * ```
  */
 export class IPCTimeoutError extends IPCError {
@@ -73,7 +73,7 @@ export class IPCTimeoutError extends IPCError {
  *
  * @example
  * ```typescript
- * throw new IPCParseError('worker_peek', 'Unexpected token in JSON');
+ * throw new IPCParseError('session_peek', 'Unexpected token in JSON');
  * ```
  */
 export class IPCParseError extends IPCError {
@@ -95,7 +95,7 @@ export class IPCParseError extends IPCError {
  *
  * @example
  * ```typescript
- * throw new IPCEarlyCloseError('worker_peek');
+ * throw new IPCEarlyCloseError('session_peek');
  * ```
  */
 export class IPCEarlyCloseError extends IPCError {

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

@@ -11,6 +11,12 @@ type WithTypeAndSession = {
 /**
  * Send IPC request and wait for response.
  * Handles connection, JSONL protocol, validation, timeout, and cleanup.
+ *
+ * @param request - Request to send
+ * @param requestName - Name used in errors and logs
+ * @param expectedType - Response type to validate, if any
+ * @param timeoutMs - How long to wait for the response (default: IPC timeout)
+ * @returns The daemon's response
  */
-export declare function sendRequest<TRequest extends WithTypeAndSession, TResponse extends WithTypeAndSession>(request: TRequest, requestName: string, expectedType?: string): Promise<TResponse>;
+export declare function sendRequest<TRequest extends WithTypeAndSession, TResponse extends WithTypeAndSession>(request: TRequest, requestName: string, expectedType?: string, timeoutMs?: number): Promise<TResponse>;
 //# sourceMappingURL=index.d.ts.map

package/dist/ipc/transport/index.js

@@ -15,10 +15,15 @@ const log = createLogger('client');
 /**
  * Send IPC request and wait for response.
  * Handles connection, JSONL protocol, validation, timeout, and cleanup.
+ *
+ * @param request - Request to send
+ * @param requestName - Name used in errors and logs
+ * @param expectedType - Response type to validate, if any
+ * @param timeoutMs - How long to wait for the response (default: IPC timeout)
+ * @returns The daemon's response
  */
-export async function sendRequest(request, requestName, expectedType) {
+export async function sendRequest(request, requestName, expectedType, timeoutMs = getIPCRequestTimeout()) {
     const socketPath = getDaemonSocketPath();
-    const timeoutMs = getIPCRequestTimeout();
     return new Promise((resolve, reject) => {
         const buffer = new JSONLBuffer();
         let resolved = false;

package/dist/ipc/transport/jsonl.d.ts

@@ -16,20 +16,46 @@ export declare class JSONLBufferOverflowError extends Error {
  * that send unbounded data without newlines.
  */
 export declare class JSONLBuffer {
-    private buffer;
+    private readonly maxSize;
+    /**
+     * @param maxSize - Longest unfinished line accepted (default {@link MAX_JSONL_BUFFER_SIZE})
+     */
+    constructor(maxSize?: number);
+    /** Chunks of the line still being received (joined once it is complete) */
+    private parts;
+    private partsLength;
     /**
      * Process incoming chunk and extract complete JSONL frames.
      *
+     * Only the new chunk is searched for line ends, and an unfinished line is
+     * kept as a list of chunks, so a large response costs linear time (joining
+     * and re-splitting the whole buffer on every chunk made multi-megabyte
+     * responses, like a big HAR, quadratic).
+     *
      * @param chunk - Incoming data chunk
      * @returns Array of complete JSONL frames (lines)
-     * @throws JSONLBufferOverflowError if buffer exceeds MAX_JSONL_BUFFER_SIZE
+     * @throws JSONLBufferOverflowError if an unfinished line exceeds the maximum size
      */
     process(chunk: string): string[];
+    /**
+     * Reject a message longer than the limit.
+     *
+     * @param length - Length of the message (so far)
+     * @throws JSONLBufferOverflowError above the maximum size
+     */
+    private assertWithinLimit;
     clear(): void;
     getBuffer(): string;
 }
 /**
  * Parse JSONL frame into typed object.
+ *
+ * Strings with a lone UTF-16 surrogate (page text cut inside an emoji, or a
+ * page logging `"\\ud83d"`) get U+FFFD in its place: printed back as JSON
+ * they would be an escape sequence that strict parsers such as jq reject.
+ *
+ * @param line - One JSON document
+ * @returns Parsed value
  */
 export declare function parseJSONLFrame<T>(line: string): T;
 /**

package/dist/ipc/transport/jsonl.js

@@ -21,36 +21,83 @@ export class JSONLBufferOverflowError extends Error {
  * that send unbounded data without newlines.
  */
 export class JSONLBuffer {
-    buffer = '';
+    maxSize;
+    /**
+     * @param maxSize - Longest unfinished line accepted (default {@link MAX_JSONL_BUFFER_SIZE})
+     */
+    constructor(maxSize = MAX_JSONL_BUFFER_SIZE) {
+        this.maxSize = maxSize;
+    }
+    /** Chunks of the line still being received (joined once it is complete) */
+    parts = [];
+    partsLength = 0;
     /**
      * Process incoming chunk and extract complete JSONL frames.
      *
+     * Only the new chunk is searched for line ends, and an unfinished line is
+     * kept as a list of chunks, so a large response costs linear time (joining
+     * and re-splitting the whole buffer on every chunk made multi-megabyte
+     * responses, like a big HAR, quadratic).
+     *
      * @param chunk - Incoming data chunk
      * @returns Array of complete JSONL frames (lines)
-     * @throws JSONLBufferOverflowError if buffer exceeds MAX_JSONL_BUFFER_SIZE
+     * @throws JSONLBufferOverflowError if an unfinished line exceeds the maximum size
      */
     process(chunk) {
-        this.buffer += chunk;
-        if (this.buffer.length > MAX_JSONL_BUFFER_SIZE) {
-            throw new JSONLBufferOverflowError(this.buffer.length, MAX_JSONL_BUFFER_SIZE);
+        const lines = [];
+        let start = 0;
+        for (let end = chunk.indexOf('\n'); end !== -1; end = chunk.indexOf('\n', start)) {
+            this.assertWithinLimit(this.partsLength + end - start);
+            this.parts.push(chunk.slice(start, end));
+            lines.push(this.parts.join(''));
+            this.parts = [];
+            this.partsLength = 0;
+            start = end + 1;
+        }
+        if (start < chunk.length) {
+            this.parts.push(chunk.slice(start));
+            this.partsLength += chunk.length - start;
         }
-        const lines = this.buffer.split('\n');
-        this.buffer = lines.pop() ?? '';
+        this.assertWithinLimit(this.partsLength);
         return lines.filter((line) => line.trim());
     }
+    /**
+     * Reject a message longer than the limit.
+     *
+     * @param length - Length of the message (so far)
+     * @throws JSONLBufferOverflowError above the maximum size
+     */
+    assertWithinLimit(length) {
+        if (length > this.maxSize)
+            throw new JSONLBufferOverflowError(length, this.maxSize);
+    }
     clear() {
-        this.buffer = '';
+        this.parts = [];
+        this.partsLength = 0;
     }
     getBuffer() {
-        return this.buffer;
+        return this.parts.join('');
     }
 }
 /**
  * Parse JSONL frame into typed object.
+ *
+ * Strings with a lone UTF-16 surrogate (page text cut inside an emoji, or a
+ * page logging `"\\ud83d"`) get U+FFFD in its place: printed back as JSON
+ * they would be an escape sequence that strict parsers such as jq reject.
+ *
+ * @param line - One JSON document
+ * @returns Parsed value
  */
 export function parseJSONLFrame(line) {
-    return JSON.parse(line);
+    if (!SURROGATE_ESCAPE.test(line))
+        return JSON.parse(line);
+    return JSON.parse(line, (_key, value) => typeof value === 'string' ? value.replace(LONE_SURROGATE, '\uFFFD') : value);
 }
+/** A surrogate escape in JSON text (only then can a string hold a lone surrogate) */
+const SURROGATE_ESCAPE = /\\u[dD][89a-fA-F]/;
+/** A high surrogate not followed by a low one, or a low one not preceded by a high one */
+const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
 /**
  * Serialize object to JSONL frame (JSON + newline).
  */

package/dist/ipc/utils/errors.d.ts

@@ -4,8 +4,10 @@
  * Utilities for detecting IPC transport-level errors.
  */
 /**
- * Detect whether an error indicates the daemon socket is unavailable.
- * Checks for ENOENT (socket file doesn't exist) and ECONNREFUSED (daemon not listening).
+ * Detect whether an error indicates the daemon socket is unavailable:
+ * the socket file doesn't exist (ENOENT) or nobody listens (ECONNREFUSED).
+ * Errors of other files (e.g. a screenshot path in a missing directory) are
+ * not connection errors, even though they also say ENOENT.
  *
  * @param error - Error from IPC transport layer
  * @returns True if error indicates daemon connection failure

package/dist/ipc/utils/errors.js

@@ -3,10 +3,15 @@
  *
  * Utilities for detecting IPC transport-level errors.
  */
+import { IPCConnectionError } from '../transport/IPCError.js';
 import { getErrorMessage } from '../../utils/errors.js';
+/** A failed socket connection or an IPC connection error (not a file error) */
+const DAEMON_CONNECTION_PATTERN = /IPC .+ connection error|\bconnect (ENOENT|ECONNREFUSED)\b/;
 /**
- * Detect whether an error indicates the daemon socket is unavailable.
- * Checks for ENOENT (socket file doesn't exist) and ECONNREFUSED (daemon not listening).
+ * Detect whether an error indicates the daemon socket is unavailable:
+ * the socket file doesn't exist (ENOENT) or nobody listens (ECONNREFUSED).
+ * Errors of other files (e.g. a screenshot path in a missing directory) are
+ * not connection errors, even though they also say ENOENT.
  *
  * @param error - Error from IPC transport layer
  * @returns True if error indicates daemon connection failure
@@ -23,7 +28,8 @@ import { getErrorMessage } from '../../utils/errors.js';
  * ```
  */
 export function isConnectionError(error) {
-    const message = getErrorMessage(error);
-    return message.includes('ENOENT') || message.includes('ECONNREFUSED');
+    if (error instanceof IPCConnectionError)
+        return true;
+    return DAEMON_CONNECTION_PATTERN.test(getErrorMessage(error));
 }
 //# sourceMappingURL=errors.js.map

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

@@ -6,7 +6,6 @@
  */
 export * from './session.js';
 export type * from './types.js';
-export * from './requestId.js';
 export * from './errors.js';
 export * from './responseValidator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ipc/utils/index.js

@@ -5,7 +5,6 @@
  * and response validation.
  */
 export * from './session.js';
-export * from './requestId.js';
 export * from './errors.js';
 export * from './responseValidator.js';
 //# sourceMappingURL=index.js.map

package/dist/ipc/utils/responseValidator.d.ts

@@ -11,6 +11,10 @@ interface BaseResponse {
     status: 'ok' | 'error';
     error?: string;
     data?: object;
+    /** Semantic exit code forwarded by the daemon */
+    exitCode?: number;
+    /** Recovery suggestion forwarded by the daemon */
+    suggestion?: string;
 }
 /**
  * Response type with success status.
@@ -31,7 +35,7 @@ type SuccessResponse<T extends BaseResponse> = T & {
  * Works with both IPCResponse (legacy) and ClientResponse (new) types.
  *
  * @param response - IPC or CDP response from daemon
- * @throws IPCError if response.status === 'error'
+ * @throws CommandError (carrying the daemon's exitCode and suggestion) if response.status === 'error'
  *
  * @example
  * ```typescript