browser-debugger-cli 0.6.0 → 0.6.2

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

@@ -0,0 +1,82 @@
+/**
+ * Structured IPC error classes.
+ *
+ * Provides type-safe error handling for IPC transport layer failures.
+ */
+/**
+ * Base class for all IPC-related errors.
+ *
+ * Extends Error to include exit codes for consistent CLI behavior.
+ */
+export declare class IPCError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+/**
+ * Error thrown when IPC connection to daemon fails.
+ *
+ * Indicates the daemon is not running or socket is unavailable.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCConnectionError(
+ *   'Failed to connect to daemon socket',
+ *   '/Users/user/.bdg/daemon.sock',
+ *   'ENOENT'
+ * );
+ * ```
+ */
+export declare class IPCConnectionError extends IPCError {
+    readonly name = "IPCConnectionError";
+    readonly socketPath: string;
+    readonly code?: string;
+    constructor(message: string, socketPath: string, code?: string);
+}
+/**
+ * Error thrown when IPC request times out.
+ *
+ * Indicates the daemon received the request but didn't respond in time.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCTimeoutError('worker_status', 5000);
+ * ```
+ */
+export declare class IPCTimeoutError extends IPCError {
+    readonly name = "IPCTimeoutError";
+    readonly requestName: string;
+    readonly timeoutMs: number;
+    constructor(requestName: string, timeoutMs: number);
+}
+/**
+ * Error thrown when IPC response parsing fails.
+ *
+ * Indicates malformed JSON or unexpected response format.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCParseError('worker_peek', 'Unexpected token in JSON');
+ * ```
+ */
+export declare class IPCParseError extends IPCError {
+    readonly name = "IPCParseError";
+    readonly requestName: string;
+    readonly cause?: Error;
+    constructor(requestName: string, message: string, cause?: Error);
+}
+/**
+ * Error thrown when connection closes before response received.
+ *
+ * Indicates daemon crashed or was killed during request processing.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCEarlyCloseError('worker_peek');
+ * ```
+ */
+export declare class IPCEarlyCloseError extends IPCError {
+    readonly name = "IPCEarlyCloseError";
+    readonly requestName: string;
+    constructor(requestName: string);
+}
+//# sourceMappingURL=IPCError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IPCError.d.ts","sourceRoot":"","sources":["../../../src/ipc/transport/IPCError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkC;CAS1E;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAyB,IAAI,wBAAwB;IACrD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAO/D;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,SAAyB,IAAI,qBAAqB;IAClD,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAKnD;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAyB,IAAI,mBAAmB;IAChD,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAE3B,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAOhE;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAyB,IAAI,wBAAwB;IACrD,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,WAAW,EAAE,MAAM;CAIhC"}

package/dist/ipc/transport/IPCError.js

@@ -0,0 +1,109 @@
+/**
+ * Structured IPC error classes.
+ *
+ * Provides type-safe error handling for IPC transport layer failures.
+ */
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+/**
+ * Base class for all IPC-related errors.
+ *
+ * Extends Error to include exit codes for consistent CLI behavior.
+ */
+export class IPCError extends Error {
+    exitCode;
+    constructor(message, exitCode = EXIT_CODES.SOFTWARE_ERROR) {
+        super(message);
+        this.name = 'IPCError';
+        this.exitCode = exitCode;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, IPCError);
+        }
+    }
+}
+/**
+ * Error thrown when IPC connection to daemon fails.
+ *
+ * Indicates the daemon is not running or socket is unavailable.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCConnectionError(
+ *   'Failed to connect to daemon socket',
+ *   '/Users/user/.bdg/daemon.sock',
+ *   'ENOENT'
+ * );
+ * ```
+ */
+export class IPCConnectionError extends IPCError {
+    name = 'IPCConnectionError';
+    socketPath;
+    code;
+    constructor(message, socketPath, code) {
+        super(message, EXIT_CODES.RESOURCE_NOT_FOUND);
+        this.socketPath = socketPath;
+        if (code !== undefined) {
+            this.code = code;
+        }
+    }
+}
+/**
+ * Error thrown when IPC request times out.
+ *
+ * Indicates the daemon received the request but didn't respond in time.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCTimeoutError('worker_status', 5000);
+ * ```
+ */
+export class IPCTimeoutError extends IPCError {
+    name = 'IPCTimeoutError';
+    requestName;
+    timeoutMs;
+    constructor(requestName, timeoutMs) {
+        super(`${requestName} request timeout after ${timeoutMs / 1000}s`, EXIT_CODES.CDP_TIMEOUT);
+        this.requestName = requestName;
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Error thrown when IPC response parsing fails.
+ *
+ * Indicates malformed JSON or unexpected response format.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCParseError('worker_peek', 'Unexpected token in JSON');
+ * ```
+ */
+export class IPCParseError extends IPCError {
+    name = 'IPCParseError';
+    requestName;
+    cause;
+    constructor(requestName, message, cause) {
+        super(`Failed to parse ${requestName} response: ${message}`, EXIT_CODES.SOFTWARE_ERROR);
+        this.requestName = requestName;
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+    }
+}
+/**
+ * Error thrown when connection closes before response received.
+ *
+ * Indicates daemon crashed or was killed during request processing.
+ *
+ * @example
+ * ```typescript
+ * throw new IPCEarlyCloseError('worker_peek');
+ * ```
+ */
+export class IPCEarlyCloseError extends IPCError {
+    name = 'IPCEarlyCloseError';
+    requestName;
+    constructor(requestName) {
+        super(`Connection closed before ${requestName} response received`, EXIT_CODES.SOFTWARE_ERROR);
+        this.requestName = requestName;
+    }
+}
+//# sourceMappingURL=IPCError.js.map

package/dist/ipc/transport/IPCError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPCError.js","sourceRoot":"","sources":["../../../src/ipc/transport/IPCError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,QAAQ,CAAS;IAEjC,YAAY,OAAe,EAAE,WAAmB,UAAU,CAAC,cAAc;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACrB,IAAI,GAAG,oBAAoB,CAAC;IACrC,UAAU,CAAS;IACnB,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,UAAkB,EAAE,IAAa;QAC5D,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAClB,IAAI,GAAG,iBAAiB,CAAC;IAClC,WAAW,CAAS;IACpB,SAAS,CAAS;IAElC,YAAY,WAAmB,EAAE,SAAiB;QAChD,KAAK,CAAC,GAAG,WAAW,0BAA0B,SAAS,GAAG,IAAI,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3F,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAChB,IAAI,GAAG,eAAe,CAAC;IAChC,WAAW,CAAS;IACX,KAAK,CAAS;IAEvC,YAAY,WAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,mBAAmB,WAAW,cAAc,OAAO,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;QACxF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IACrB,IAAI,GAAG,oBAAoB,CAAC;IACrC,WAAW,CAAS;IAEpC,YAAY,WAAmB;QAC7B,KAAK,CAAC,4BAA4B,WAAW,oBAAoB,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;QAC9F,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * Transport Error Formatting
+ *
+ * Formats transport-layer errors with context using structured error classes.
+ */
+import { IPCConnectionError, IPCParseError, IPCTimeoutError, IPCEarlyCloseError } from './IPCError.js';
+export declare function formatConnectionError(requestName: string, socketPath: string, error: Error): IPCConnectionError;
+export declare function formatParseError(requestName: string, error: unknown): IPCParseError;
+export declare function formatTimeoutError(requestName: string, timeoutMs: number): IPCTimeoutError;
+export declare function formatEarlyCloseError(requestName: string): IPCEarlyCloseError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/ipc/transport/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ipc/transport/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,GACX,kBAAkB,CASpB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAGnF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAE1F;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAE7E"}

package/dist/ipc/transport/errors.js

@@ -0,0 +1,28 @@
+/**
+ * Transport Error Formatting
+ *
+ * Formats transport-layer errors with context using structured error classes.
+ */
+import { getErrorMessage } from '../../utils/errors.js';
+import { IPCConnectionError, IPCParseError, IPCTimeoutError, IPCEarlyCloseError, } from './IPCError.js';
+export function formatConnectionError(requestName, socketPath, error) {
+    const code = error.code;
+    const message = [
+        `IPC ${requestName} connection error`,
+        `Socket: ${socketPath}`,
+        ...(code ? [`Code: ${code}`] : []),
+        `Details: ${error.message}`,
+    ].join(' | ');
+    return new IPCConnectionError(message, socketPath, code);
+}
+export function formatParseError(requestName, error) {
+    const cause = error instanceof Error ? error : undefined;
+    return new IPCParseError(requestName, getErrorMessage(error), cause);
+}
+export function formatTimeoutError(requestName, timeoutMs) {
+    return new IPCTimeoutError(requestName, timeoutMs);
+}
+export function formatEarlyCloseError(requestName) {
+    return new IPCEarlyCloseError(requestName);
+}
+//# sourceMappingURL=errors.js.map

package/dist/ipc/transport/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ipc/transport/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,UAAkB,EAClB,KAAY;IAEZ,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;IACnD,MAAM,OAAO,GAAG;QACd,OAAO,WAAW,mBAAmB;QACrC,WAAW,UAAU,EAAE;QACvB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,YAAY,KAAK,CAAC,OAAO,EAAE;KAC5B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACd,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,KAAc;IAClE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,SAAiB;IACvE,OAAO,IAAI,eAAe,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * IPC Transport Layer
+ *
+ * Handles Unix domain socket communication with JSONL protocol.
+ */
+export { IPCError, IPCConnectionError, IPCTimeoutError, IPCParseError, IPCEarlyCloseError, } from './IPCError.js';
+type WithTypeAndSession = {
+    type: string;
+    sessionId: string;
+};
+/**
+ * Send IPC request and wait for response.
+ * Handles connection, JSONL protocol, validation, timeout, and cleanup.
+ */
+export declare function sendRequest<TRequest extends WithTypeAndSession, TResponse extends WithTypeAndSession>(request: TRequest, requestName: string, expectedType?: string): Promise<TResponse>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ipc/transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAIvB,KAAK,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,SAAS,kBAAkB,EACnC,SAAS,SAAS,kBAAkB,EACpC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmEnF"}

package/dist/ipc/transport/index.js

@@ -0,0 +1,77 @@
+/**
+ * IPC Transport Layer
+ *
+ * Handles Unix domain socket communication with JSONL protocol.
+ */
+import { getIPCRequestTimeout } from '../../constants.js';
+import { getDaemonSocketPath } from '../../session/paths.js';
+import { createLogger } from '../../ui/logging/index.js';
+import { formatConnectionError, formatEarlyCloseError, formatParseError, formatTimeoutError, } from './errors.js';
+import { JSONLBuffer, parseJSONLFrame, toJSONLFrame } from './jsonl.js';
+import { createSocket } from './socket.js';
+import { validateResponseType, validateSessionId } from './validation.js';
+// Export structured error classes for external use
+export { IPCError, IPCConnectionError, IPCTimeoutError, IPCParseError, IPCEarlyCloseError, } from './IPCError.js';
+const log = createLogger('client');
+/**
+ * Send IPC request and wait for response.
+ * Handles connection, JSONL protocol, validation, timeout, and cleanup.
+ */
+export async function sendRequest(request, requestName, expectedType) {
+    const socketPath = getDaemonSocketPath();
+    const timeoutMs = getIPCRequestTimeout();
+    return new Promise((resolve, reject) => {
+        const buffer = new JSONLBuffer();
+        let resolved = false;
+        const resolveOnce = (cleanup, error, response) => {
+            if (resolved)
+                return;
+            resolved = true;
+            cleanup();
+            if (error) {
+                reject(error);
+            }
+            else if (response) {
+                resolve(response);
+            }
+        };
+        const { cleanup } = createSocket({ socketPath, timeoutMs, requestName }, {
+            onConnect: (s) => {
+                s.write(toJSONLFrame(request));
+                log.debug(`${requestName} request sent`);
+            },
+            onData: (chunk) => {
+                const lines = buffer.process(chunk);
+                for (const line of lines) {
+                    if (resolved)
+                        return;
+                    try {
+                        const response = parseJSONLFrame(line);
+                        log.debug(`${requestName} response received`);
+                        validateSessionId(request, response, requestName);
+                        if (expectedType) {
+                            validateResponseType(response, expectedType, requestName);
+                        }
+                        resolveOnce(cleanup, undefined, response);
+                    }
+                    catch (error) {
+                        resolveOnce(cleanup, formatParseError(requestName, error));
+                    }
+                }
+            },
+            onError: (err) => {
+                resolveOnce(cleanup, formatConnectionError(requestName, socketPath, err));
+            },
+            onClose: () => {
+                resolveOnce(cleanup, formatEarlyCloseError(requestName));
+            },
+            onEnd: () => {
+                resolveOnce(cleanup, formatEarlyCloseError(requestName));
+            },
+            onTimeout: () => {
+                resolveOnce(cleanup, formatTimeoutError(requestName, timeoutMs));
+            },
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/ipc/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ipc/transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,mDAAmD;AACnD,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAInC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAG/B,OAAiB,EAAE,WAAmB,EAAE,YAAqB;IAC7D,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,WAAW,GAAG,CAAC,OAAmB,EAAE,KAAa,EAAE,QAAoB,EAAQ,EAAE;YACrF,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;iBAAM,IAAI,QAAQ,EAAE,CAAC;gBACpB,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAC9B,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,EACtC;YACE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;gBACf,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC/B,GAAG,CAAC,KAAK,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;YAC3C,CAAC;YAED,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,QAAQ;wBAAE,OAAO;oBAErB,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,eAAe,CAAY,IAAI,CAAC,CAAC;wBAClD,GAAG,CAAC,KAAK,CAAC,GAAG,WAAW,oBAAoB,CAAC,CAAC;wBAE9C,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;wBAClD,IAAI,YAAY,EAAE,CAAC;4BACjB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;wBAC5D,CAAC;wBAED,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;oBAC5C,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5E,CAAC;YAED,OAAO,EAAE,GAAG,EAAE;gBACZ,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,KAAK,EAAE,GAAG,EAAE;gBACV,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,SAAS,EAAE,GAAG,EAAE;gBACd,WAAW,CAAC,OAAO,EAAE,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;YACnE,CAAC;SACF,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * JSONL Protocol Handler
+ *
+ * Utilities for parsing newline-delimited JSON streams.
+ */
+/**
+ * Error thrown when JSONL buffer exceeds maximum size.
+ */
+export declare class JSONLBufferOverflowError extends Error {
+    constructor(bufferSize: number, maxSize: number);
+}
+/**
+ * JSONL buffer for accumulating partial frames.
+ *
+ * Enforces a maximum buffer size to prevent OOM attacks from processes
+ * that send unbounded data without newlines.
+ */
+export declare class JSONLBuffer {
+    private buffer;
+    /**
+     * Process incoming chunk and extract complete JSONL frames.
+     *
+     * @param chunk - Incoming data chunk
+     * @returns Array of complete JSONL frames (lines)
+     * @throws JSONLBufferOverflowError if buffer exceeds MAX_JSONL_BUFFER_SIZE
+     */
+    process(chunk: string): string[];
+    clear(): void;
+    getBuffer(): string;
+}
+/**
+ * Parse JSONL frame into typed object.
+ */
+export declare function parseJSONLFrame<T>(line: string): T;
+/**
+ * Serialize object to JSONL frame (JSON + newline).
+ */
+export declare function toJSONLFrame(obj: unknown): string;
+//# sourceMappingURL=jsonl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/ipc/transport/jsonl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAOhD;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAM;IAEpB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAahC,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,MAAM;CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/ipc/transport/jsonl.js

@@ -0,0 +1,61 @@
+/**
+ * JSONL Protocol Handler
+ *
+ * Utilities for parsing newline-delimited JSON streams.
+ */
+import { MAX_JSONL_BUFFER_SIZE } from '../../constants.js';
+/**
+ * Error thrown when JSONL buffer exceeds maximum size.
+ */
+export class JSONLBufferOverflowError extends Error {
+    constructor(bufferSize, maxSize) {
+        super(`JSONL buffer overflow: ${bufferSize} bytes exceeds maximum ${maxSize} bytes. ` +
+            `Possible malicious or buggy process sending data without newlines.`);
+        this.name = 'JSONLBufferOverflowError';
+    }
+}
+/**
+ * JSONL buffer for accumulating partial frames.
+ *
+ * Enforces a maximum buffer size to prevent OOM attacks from processes
+ * that send unbounded data without newlines.
+ */
+export class JSONLBuffer {
+    buffer = '';
+    /**
+     * Process incoming chunk and extract complete JSONL frames.
+     *
+     * @param chunk - Incoming data chunk
+     * @returns Array of complete JSONL frames (lines)
+     * @throws JSONLBufferOverflowError if buffer exceeds MAX_JSONL_BUFFER_SIZE
+     */
+    process(chunk) {
+        this.buffer += chunk;
+        // Check buffer size before processing to prevent OOM
+        if (this.buffer.length > MAX_JSONL_BUFFER_SIZE) {
+            throw new JSONLBufferOverflowError(this.buffer.length, MAX_JSONL_BUFFER_SIZE);
+        }
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        return lines.filter((line) => line.trim());
+    }
+    clear() {
+        this.buffer = '';
+    }
+    getBuffer() {
+        return this.buffer;
+    }
+}
+/**
+ * Parse JSONL frame into typed object.
+ */
+export function parseJSONLFrame(line) {
+    return JSON.parse(line);
+}
+/**
+ * Serialize object to JSONL frame (JSON + newline).
+ */
+export function toJSONLFrame(obj) {
+    return JSON.stringify(obj) + '\n';
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/ipc/transport/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../../src/ipc/transport/jsonl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,UAAkB,EAAE,OAAe;QAC7C,KAAK,CACH,0BAA0B,UAAU,0BAA0B,OAAO,UAAU;YAC7E,oEAAoE,CACvE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,GAAG,EAAE,CAAC;IAEpB;;;;;;OAMG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QAErB,qDAAqD;QACrD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;YAC/C,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAI,IAAY;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Socket Connection Manager
+ *
+ * Manages Unix domain socket connections with proper cleanup.
+ */
+import type { Socket } from 'net';
+export interface SocketConfig {
+    socketPath: string;
+    timeoutMs: number;
+    requestName: string;
+}
+export interface SocketHandlers {
+    onConnect?: (socket: Socket) => void;
+    onData?: (chunk: string) => void;
+    onError?: (error: Error) => void;
+    onClose?: () => void;
+    onEnd?: () => void;
+    onTimeout?: () => void;
+}
+/**
+ * Create and configure a socket connection with event handlers.
+ */
+export declare function createSocket(config: SocketConfig, handlers: SocketHandlers): {
+    socket: Socket;
+    cleanup: () => void;
+};
+//# sourceMappingURL=socket.d.ts.map

package/dist/ipc/transport/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/ipc/transport/socket.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAMlC,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,GACvB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA6CzC"}

package/dist/ipc/transport/socket.js

@@ -0,0 +1,49 @@
+/**
+ * Socket Connection Manager
+ *
+ * Manages Unix domain socket connections with proper cleanup.
+ */
+import { connect } from 'net';
+import { createLogger } from '../../ui/logging/index.js';
+const log = createLogger('client');
+/**
+ * Create and configure a socket connection with event handlers.
+ */
+export function createSocket(config, handlers) {
+    const socket = connect(config.socketPath);
+    let timeoutHandle = null;
+    socket.setEncoding('utf8');
+    socket.setNoDelay(true);
+    if (handlers.onTimeout) {
+        timeoutHandle = setTimeout(() => {
+            handlers.onTimeout?.();
+        }, config.timeoutMs);
+    }
+    if (handlers.onConnect) {
+        socket.once('connect', () => {
+            log.debug(`Connected to daemon for ${config.requestName} request`);
+            handlers.onConnect?.(socket);
+        });
+    }
+    if (handlers.onData) {
+        socket.on('data', handlers.onData);
+    }
+    if (handlers.onError) {
+        socket.once('error', handlers.onError);
+    }
+    if (handlers.onClose) {
+        socket.once('close', handlers.onClose);
+    }
+    if (handlers.onEnd) {
+        socket.once('end', handlers.onEnd);
+    }
+    const cleanup = () => {
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+            timeoutHandle = null;
+        }
+        socket.destroy();
+    };
+    return { socket, cleanup };
+}
+//# sourceMappingURL=socket.js.map

package/dist/ipc/transport/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../src/ipc/transport/socket.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAI9B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAiBnC;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAoB,EACpB,QAAwB;IAExB,MAAM,MAAM,GAAW,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,aAAa,GAA0B,IAAI,CAAC;IAEhD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAExB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;QACzB,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,GAAG,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,WAAW,UAAU,CAAC,CAAC;YACnE,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,aAAa,EAAE,CAAC;YAClB,YAAY,CAAC,aAAa,CAAC,CAAC;YAC5B,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Response Validation
+ *
+ * Validates IPC response messages match request expectations.
+ */
+type WithSessionId = {
+    sessionId: string;
+};
+type WithType = {
+    type: string;
+};
+/**
+ * Validate response session ID matches request.
+ */
+export declare function validateSessionId<TReq extends WithSessionId, TRes extends WithSessionId>(request: TReq, response: TRes, requestName: string): void;
+/**
+ * Validate response type matches expected type.
+ */
+export declare function validateResponseType<T extends WithType>(response: T, expectedType: string, requestName: string): void;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/ipc/transport/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/ipc/transport/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,KAAK,aAAa,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3C,KAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,aAAa,EAAE,IAAI,SAAS,aAAa,EACtF,OAAO,EAAE,IAAI,EACb,QAAQ,EAAE,IAAI,EACd,WAAW,EAAE,MAAM,GAClB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EACrD,QAAQ,EAAE,CAAC,EACX,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,IAAI,CAON"}

package/dist/ipc/transport/validation.js

@@ -0,0 +1,23 @@
+/**
+ * Response Validation
+ *
+ * Validates IPC response messages match request expectations.
+ */
+import { IPCParseError } from './IPCError.js';
+/**
+ * Validate response session ID matches request.
+ */
+export function validateSessionId(request, response, requestName) {
+    if (response.sessionId !== request.sessionId) {
+        throw new IPCParseError(requestName, `Response sessionId mismatch: expected ${request.sessionId}, got ${response.sessionId}`);
+    }
+}
+/**
+ * Validate response type matches expected type.
+ */
+export function validateResponseType(response, expectedType, requestName) {
+    if (response.type !== expectedType) {
+        throw new IPCParseError(requestName, `Unexpected response type: ${response.type} (expected ${expectedType})`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/ipc/transport/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/ipc/transport/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK9C;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAa,EACb,QAAc,EACd,WAAmB;IAEnB,IAAI,QAAQ,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;QAC7C,MAAM,IAAI,aAAa,CACrB,WAAW,EACX,yCAAyC,OAAO,CAAC,SAAS,SAAS,QAAQ,CAAC,SAAS,EAAE,CACxF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAW,EACX,YAAoB,EACpB,WAAmB;IAEnB,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACnC,MAAM,IAAI,aAAa,CACrB,WAAW,EACX,6BAA6B,QAAQ,CAAC,IAAI,cAAc,YAAY,GAAG,CACxE,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * IPC Error Detection
+ *
+ * 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).
+ *
+ * @param error - Error from IPC transport layer
+ * @returns True if error indicates daemon connection failure
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await connectToDaemon();
+ * } catch (error) {
+ *   if (isConnectionError(error)) {
+ *     console.error('Daemon not running. Start with: bdg <url>');
+ *   }
+ * }
+ * ```
+ */
+export declare function isConnectionError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ipc/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGzD"}