browser-debugger-cli 0.5.1 → 0.6.1

package/dist/ipc/index.js

@@ -0,0 +1,23 @@
+/**
+ * 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)
+ */
+// Public client API
+export * from './client.js';
+// Session message types
+export * from './session/index.js';
+// Protocol types (worker commands)
+export * from './protocol/index.js';
+// Validation utilities (re-exported from utils for public API)
+export { validateIPCResponse } from './utils/responseValidator.js';
+// Note: transport/ is internal and not exported (used by client.ts)
+// Note: other utils are internal and not exported (except validateIPCResponse)
+//# sourceMappingURL=index.js.map

package/dist/ipc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ipc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oBAAoB;AACpB,cAAc,aAAa,CAAC;AAE5B,wBAAwB;AACxB,cAAc,oBAAoB,CAAC;AAEnC,mCAAmC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,oEAAoE;AACpE,+EAA+E"}

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

@@ -0,0 +1,144 @@
+/**
+ * Worker Command Schemas
+ *
+ * Defines the request/response schemas for commands sent to the worker process.
+ * Each command has a request schema (input) and response data schema (output).
+ */
+import type { PageState, SessionActivity } from '../../ipc/session/types.js';
+/**
+ * Worker peek command request schema.
+ */
+export interface WorkerPeekCommand {
+    /** Number of recent items to return. */
+    lastN?: number;
+    /** Offset from the end (for pagination). Default: 0 (most recent). */
+    offset?: number;
+}
+/**
+ * Worker peek command response data.
+ */
+export interface WorkerPeekData {
+    version: string;
+    startTime: number;
+    duration: number;
+    target: {
+        url: string;
+        title: string;
+    };
+    activeTelemetry: string[];
+    network: Array<{
+        requestId: string;
+        timestamp: number;
+        method: string;
+        url: string;
+        status?: number;
+        mimeType?: string;
+    }>;
+    console: Array<{
+        timestamp: number;
+        type: string;
+        text: string;
+    }>;
+    /** Total number of network requests (for pagination). */
+    totalNetwork?: number;
+    /** Total number of console messages (for pagination). */
+    totalConsole?: number;
+    /** Whether there are more network items available. */
+    hasMoreNetwork?: boolean;
+    /** Whether there are more console items available. */
+    hasMoreConsole?: boolean;
+}
+/**
+ * Worker details command request schema.
+ */
+export interface WorkerDetailsCommand {
+    /** Type of item to get details for. */
+    itemType: 'network' | 'console';
+    /** Unique identifier of the item. */
+    id: string;
+}
+/**
+ * Worker details command response data.
+ */
+export interface WorkerDetailsData {
+    /** The requested item (network request or console message). */
+    item: unknown;
+}
+/**
+ * CDP call command request schema.
+ */
+export interface CdpCallCommand {
+    /** CDP method name (e.g., 'Network.getCookies'). */
+    method: string;
+    /** Optional parameters for the CDP method. */
+    params?: Record<string, unknown>;
+}
+/**
+ * CDP call command response data.
+ */
+export interface CdpCallData {
+    /** Result from CDP method call. */
+    result: unknown;
+}
+/**
+ * Worker status command request schema (no parameters required).
+ */
+export type WorkerStatusCommand = Record<string, unknown>;
+/**
+ * Worker status command response data.
+ */
+export interface WorkerStatusData {
+    startTime: number;
+    duration: number;
+    target: PageState;
+    activeTelemetry: string[];
+    activity: SessionActivity;
+}
+/**
+ * Command definition structure.
+ */
+type CommandDef<TReq, TRes> = {
+    requestSchema: TReq;
+    responseSchema: TRes;
+};
+/**
+ * Shape of the command registry.
+ */
+export type RegistryShape = {
+    worker_peek: CommandDef<WorkerPeekCommand, WorkerPeekData>;
+    worker_details: CommandDef<WorkerDetailsCommand, WorkerDetailsData>;
+    worker_status: CommandDef<WorkerStatusCommand, WorkerStatusData>;
+    cdp_call: CommandDef<CdpCallCommand, CdpCallData>;
+};
+/**
+ * Central registry of all worker commands.
+ * Maps command names to their request/response schemas.
+ */
+export declare const COMMANDS: {
+    readonly worker_peek: {
+        readonly requestSchema: WorkerPeekCommand;
+        readonly responseSchema: WorkerPeekData;
+    };
+    readonly worker_details: {
+        readonly requestSchema: WorkerDetailsCommand;
+        readonly responseSchema: WorkerDetailsData;
+    };
+    readonly worker_status: {
+        readonly requestSchema: WorkerStatusCommand;
+        readonly responseSchema: WorkerStatusData;
+    };
+    readonly cdp_call: {
+        readonly requestSchema: CdpCallCommand;
+        readonly responseSchema: CdpCallData;
+    };
+};
+/**
+ * All registered command schemas.
+ */
+export type CommandSchemas = typeof COMMANDS;
+/**
+ * All valid command names.
+ */
+export type CommandName = keyof typeof COMMANDS;
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/ipc/protocol/commands.d.ts.map

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

package/dist/ipc/protocol/commands.js

@@ -0,0 +1,23 @@
+/**
+ * Worker Command Schemas
+ *
+ * Defines the request/response schemas for commands sent to the worker process.
+ * Each command has a request schema (input) and response data schema (output).
+ */
+/**
+ * Central registry of all worker commands.
+ * Maps command names to their request/response schemas.
+ */
+export const COMMANDS = {
+    worker_peek: { requestSchema: {}, responseSchema: {} },
+    worker_details: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    worker_status: {
+        requestSchema: {},
+        responseSchema: {},
+    },
+    cdp_call: { requestSchema: {}, responseSchema: {} },
+};
+//# sourceMappingURL=commands.js.map

package/dist/ipc/protocol/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/ipc/protocol/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6GH;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,EAAE,aAAa,EAAE,EAAuB,EAAE,cAAc,EAAE,EAAoB,EAAE;IAC7F,cAAc,EAAE;QACd,aAAa,EAAE,EAA0B;QACzC,cAAc,EAAE,EAAuB;KACxC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,EAAyB;QACxC,cAAc,EAAE,EAAsB;KACvC;IACD,QAAQ,EAAE,EAAE,aAAa,EAAE,EAAoB,EAAE,cAAc,EAAE,EAAiB,EAAE;CACpD,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Type Guards for IPC Protocol
+ *
+ * Runtime type guards for identifying message types.
+ */
+import { type CommandName } from './commands.js';
+/**
+ * Check if a message type is a command request.
+ *
+ * @param type - Message type string
+ * @returns True if type matches pattern command_name_request
+ *
+ * @example
+ * ```typescript
+ * isCommandRequest('worker_peek_request') // true
+ * isCommandRequest('status_request')      // false
+ * ```
+ */
+export declare function isCommandRequest(type: string): type is `${CommandName}_request`;
+/**
+ * Check if a message type is a command response.
+ *
+ * @param type - Message type string
+ * @returns True if type matches pattern command_name_response
+ *
+ * @example
+ * ```typescript
+ * isCommandResponse('worker_peek_response') // true
+ * isCommandResponse('status_response')      // false
+ * ```
+ */
+export declare function isCommandResponse(type: string): type is `${CommandName}_response`;
+/**
+ * Extract command name from a message type string.
+ *
+ * @param type - Message type string (request or response)
+ * @returns Command name if valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * getCommandName('worker_peek_request')  // 'worker_peek'
+ * getCommandName('worker_peek_response') // 'worker_peek'
+ * getCommandName('status_request')       // null
+ * ```
+ */
+export declare function getCommandName(type: string): CommandName | null;
+//# sourceMappingURL=guards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/ipc/protocol/guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,GAAG,WAAW,UAAU,CAI/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,GAAG,WAAW,WAAW,CAIjF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI/D"}

package/dist/ipc/protocol/guards.js

@@ -0,0 +1,62 @@
+/**
+ * Type Guards for IPC Protocol
+ *
+ * Runtime type guards for identifying message types.
+ */
+import { COMMANDS } from './commands.js';
+/**
+ * Check if a message type is a command request.
+ *
+ * @param type - Message type string
+ * @returns True if type matches pattern command_name_request
+ *
+ * @example
+ * ```typescript
+ * isCommandRequest('worker_peek_request') // true
+ * isCommandRequest('status_request')      // false
+ * ```
+ */
+export function isCommandRequest(type) {
+    if (!type.endsWith('_request'))
+        return false;
+    const commandName = type.replace('_request', '');
+    return commandName in COMMANDS;
+}
+/**
+ * Check if a message type is a command response.
+ *
+ * @param type - Message type string
+ * @returns True if type matches pattern command_name_response
+ *
+ * @example
+ * ```typescript
+ * isCommandResponse('worker_peek_response') // true
+ * isCommandResponse('status_response')      // false
+ * ```
+ */
+export function isCommandResponse(type) {
+    if (!type.endsWith('_response'))
+        return false;
+    const commandName = type.replace('_response', '');
+    return commandName in COMMANDS;
+}
+/**
+ * Extract command name from a message type string.
+ *
+ * @param type - Message type string (request or response)
+ * @returns Command name if valid, null otherwise
+ *
+ * @example
+ * ```typescript
+ * getCommandName('worker_peek_request')  // 'worker_peek'
+ * getCommandName('worker_peek_response') // 'worker_peek'
+ * getCommandName('status_request')       // null
+ * ```
+ */
+export function getCommandName(type) {
+    if (!type.endsWith('_request') && !type.endsWith('_response'))
+        return null;
+    const commandName = type.replace(/_request|_response/, '');
+    return commandName in COMMANDS ? commandName : null;
+}
+//# sourceMappingURL=guards.js.map

package/dist/ipc/protocol/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/ipc/protocol/guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAgB,CAAC;IAChE,OAAO,WAAW,IAAI,QAAQ,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAgB,CAAC;IACjE,OAAO,WAAW,IAAI,QAAQ,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAgB,CAAC;IAC1E,OAAO,WAAW,IAAI,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * IPC Protocol Layer
+ *
+ * Exports command schemas, message type constructors, and type guards.
+ */
+export * from './commands.js';
+export type * from './messages.js';
+export * from './guards.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ipc/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,mBAAmB,eAAe,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/dist/ipc/protocol/index.js

@@ -0,0 +1,8 @@
+/**
+ * IPC Protocol Layer
+ *
+ * Exports command schemas, message type constructors, and type guards.
+ */
+export * from './commands.js';
+export * from './guards.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ipc/protocol/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAE9B,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * IPC Message Type Constructors
+ *
+ * Generic types for constructing strongly-typed request/response messages
+ * for both worker communication and 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;
+} & (typeof COMMANDS)[T]['requestSchema'];
+/**
+ * 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.
+ */
+export type ClientRequest<T extends CommandName> = {
+    type: `${T}_request`;
+    sessionId: string;
+} & (typeof COMMANDS)[T]['requestSchema'];
+/**
+ * Client response message (daemon → CLI).
+ * Uses status instead of success for consistency with session messages.
+ */
+export type ClientResponse<T extends CommandName> = {
+    type: `${T}_response`;
+    sessionId: string;
+    status: 'ok' | 'error';
+    data?: (typeof COMMANDS)[T]['responseSchema'];
+    error?: 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.
+ */
+export type ClientRequestUnion = {
+    [K in CommandName]: ClientRequest<K>;
+}[CommandName];
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/ipc/protocol/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI;IACjD,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI;IAClD,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI;IACjD,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI;IAClD,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;KAAG,CAAC,IAAI,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC;CAAE,CAAC,WAAW,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;KAAG,CAAC,IAAI,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC;CAAE,CAAC,WAAW,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;KAAG,CAAC,IAAI,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC;CAAE,CAAC,WAAW,CAAC,CAAC"}

package/dist/ipc/protocol/messages.js

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

package/dist/ipc/protocol/messages.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * IPC Error Codes
+ *
+ * Semantic error codes for session-related failures.
+ */
+/**
+ * Error codes returned in IPC responses.
+ */
+export declare enum IPCErrorCode {
+    /** No active session exists. */
+    NO_SESSION = "NO_SESSION",
+    /** Failed to kill session process. */
+    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",
+    /** Chrome browser failed to launch. */
+    CHROME_LAUNCH_FAILED = "CHROME_LAUNCH_FAILED",
+    /** CDP connection timeout. */
+    CDP_TIMEOUT = "CDP_TIMEOUT",
+    /** Generic daemon error. */
+    DAEMON_ERROR = "DAEMON_ERROR"
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ipc/session/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,YAAY;IACtB,gCAAgC;IAChC,UAAU,eAAe;IACzB,sCAAsC;IACtC,mBAAmB,wBAAwB;IAC3C,8DAA8D;IAC9D,uBAAuB,4BAA4B;IACnD,sCAAsC;IACtC,mBAAmB,wBAAwB;IAC3C,uCAAuC;IACvC,oBAAoB,yBAAyB;IAC7C,8BAA8B;IAC9B,WAAW,gBAAgB;IAC3B,4BAA4B;IAC5B,YAAY,iBAAiB;CAC9B"}

package/dist/ipc/{types.js → session/errors.js}

@@ -1,21 +1,26 @@
 /**
- * IPC Protocol Types - Minimal JSONL handshake MVP
+ * IPC Error Codes
  *
- * This module defines the bare minimum message types needed to establish
- * a handshake between the CLI client and the daemon over JSONL protocol.
+ * Semantic error codes for session-related failures.
  */
 /**
- * Error codes for IPC responses.
- * Provides structured error handling across daemon and CLI.
+ * Error codes returned in IPC responses.
  */
 export var IPCErrorCode;
 (function (IPCErrorCode) {
+    /** No active session exists. */
     IPCErrorCode["NO_SESSION"] = "NO_SESSION";
+    /** Failed to kill session process. */
     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";
+    /** Chrome browser failed to launch. */
     IPCErrorCode["CHROME_LAUNCH_FAILED"] = "CHROME_LAUNCH_FAILED";
+    /** CDP connection timeout. */
     IPCErrorCode["CDP_TIMEOUT"] = "CDP_TIMEOUT";
+    /** Generic daemon error. */
     IPCErrorCode["DAEMON_ERROR"] = "DAEMON_ERROR";
 })(IPCErrorCode || (IPCErrorCode = {}));
-//# sourceMappingURL=types.js.map
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ipc/session/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,YAeX;AAfD,WAAY,YAAY;IACtB,gCAAgC;IAChC,yCAAyB,CAAA;IACzB,sCAAsC;IACtC,2DAA2C,CAAA;IAC3C,8DAA8D;IAC9D,mEAAmD,CAAA;IACnD,sCAAsC;IACtC,2DAA2C,CAAA;IAC3C,uCAAuC;IACvC,6DAA6C,CAAA;IAC7C,8BAA8B;IAC9B,2CAA2B,CAAA;IAC3B,4BAA4B;IAC5B,6CAA6B,CAAA;AAC/B,CAAC,EAfW,YAAY,KAAZ,YAAY,QAevB"}

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

@@ -0,0 +1,16 @@
+/**
+ * Session Messages
+ *
+ * Exports all session-related message types: lifecycle, queries, and errors.
+ */
+export * from './errors.js';
+export type * from './lifecycle.js';
+export type * from './queries.js';
+export type * from './types.js';
+import type { LifecycleMessageType } from './lifecycle.js';
+import type { QueryMessageType } from './queries.js';
+/**
+ * Union of all IPC message types (lifecycle + queries).
+ */
+export type IPCMessageType = LifecycleMessageType | QueryMessageType;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ipc/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,YAAY,CAAC;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,gBAAgB,CAAC"}

package/dist/ipc/session/index.js

@@ -0,0 +1,7 @@
+/**
+ * Session Messages
+ *
+ * Exports all session-related message types: lifecycle, queries, and errors.
+ */
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ipc/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,125 @@
+/**
+ * Session Lifecycle Messages
+ *
+ * Types for handshake, start session, and stop session operations.
+ */
+import type { IPCErrorCode } from './errors.js';
+import type { TelemetryType } from '../../types.js';
+/**
+ * Base message interface with type and session ID.
+ */
+export interface IPCMessage {
+    type: string;
+    sessionId: string;
+}
+/**
+ * Handshake request (client → daemon).
+ */
+export interface HandshakeRequest extends IPCMessage {
+    type: 'handshake_request';
+}
+/**
+ * Handshake response (daemon → client).
+ */
+export interface HandshakeResponse extends IPCMessage {
+    type: 'handshake_response';
+    status: 'ok' | 'error';
+    message?: string;
+}
+/**
+ * Session start options.
+ */
+export interface SessionOptions {
+    /** 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;
+}
+/**
+ * Start session request (client → daemon).
+ */
+export interface StartSessionRequest extends IPCMessage {
+    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;
+}
+/**
+ * Start session response data.
+ */
+export interface StartSessionResponseData {
+    /** Worker process ID. */
+    workerPid: number;
+    /** Chrome process ID. */
+    chromePid: number;
+    /** CDP port. */
+    port: number;
+    /** Target page URL. */
+    targetUrl: string;
+    /** Target page title. */
+    targetTitle?: string;
+}
+/**
+ * Start session response (daemon → client).
+ */
+export interface StartSessionResponse extends IPCMessage {
+    type: 'start_session_response';
+    status: 'ok' | 'error';
+    data?: StartSessionResponseData;
+    message?: string;
+    errorCode?: IPCErrorCode;
+    existingSession?: {
+        pid: number;
+        targetUrl?: string;
+        startTime?: number;
+        duration?: number;
+    };
+}
+/**
+ * Stop session request (client → daemon).
+ */
+export interface StopSessionRequest extends IPCMessage {
+    type: 'stop_session_request';
+}
+/**
+ * Stop session response (daemon → client).
+ */
+export interface StopSessionResponse extends IPCMessage {
+    type: 'stop_session_response';
+    status: 'ok' | 'error';
+    message?: string;
+    errorCode?: IPCErrorCode;
+    chromePid?: number;
+}
+/**
+ * Union of all session lifecycle message types.
+ */
+export type LifecycleMessageType = HandshakeRequest | HandshakeResponse | StartSessionRequest | StartSessionResponse | StopSessionRequest | StopSessionResponse;
+//# sourceMappingURL=lifecycle.d.ts.map