browser-debugger-cli 0.6.9 → 0.6.11

package/dist/utils/exitCodes.js

@@ -32,37 +32,107 @@
  * **These values are stable API** - use confidently in automation scripts.
  */
 export const EXIT_CODES = {
-    /** Command completed successfully */
     SUCCESS: 0,
-    /** Generic failure (use specific codes when possible) */
     GENERIC_FAILURE: 1,
-    /** Invalid URL format or unreachable URL */
     INVALID_URL: 80,
-    /** Invalid command-line arguments or options */
     INVALID_ARGUMENTS: 81,
-    /** Insufficient permissions for operation */
     PERMISSION_DENIED: 82,
-    /** Requested resource not found (session, file, etc.) */
     RESOURCE_NOT_FOUND: 83,
-    /** Resource already exists (duplicate session, etc.) */
     RESOURCE_ALREADY_EXISTS: 84,
-    /** Resource is locked or busy */
     RESOURCE_BUSY: 85,
-    /** Daemon already running when trying to start */
     DAEMON_ALREADY_RUNNING: 86,
-    /** Chrome browser failed to launch */
+    STALE_CACHE: 87,
     CHROME_LAUNCH_FAILURE: 100,
-    /** CDP connection failed */
     CDP_CONNECTION_FAILURE: 101,
-    /** CDP operation timed out */
     CDP_TIMEOUT: 102,
-    /** Session file read/write error */
     SESSION_FILE_ERROR: 103,
-    /** Unhandled exception in code */
     UNHANDLED_EXCEPTION: 104,
-    /** Signal handler error */
     SIGNAL_HANDLER_ERROR: 105,
-    /** Generic software error (use specific codes when possible) */
     SOFTWARE_ERROR: 110,
 };
+/**
+ * Exit code registry - provides documentation for all exit codes.
+ *
+ * This registry is derived from EXIT_CODES to ensure consistency.
+ * Used by help --json for machine-readable documentation.
+ */
+export const EXIT_CODE_REGISTRY = [
+    { code: EXIT_CODES.SUCCESS, name: 'SUCCESS', description: 'Operation completed successfully' },
+    {
+        code: EXIT_CODES.GENERIC_FAILURE,
+        name: 'GENERIC_FAILURE',
+        description: 'Generic failure (use specific codes when possible)',
+    },
+    {
+        code: EXIT_CODES.INVALID_URL,
+        name: 'INVALID_URL',
+        description: 'Invalid URL format or unreachable URL',
+    },
+    {
+        code: EXIT_CODES.INVALID_ARGUMENTS,
+        name: 'INVALID_ARGUMENTS',
+        description: 'Invalid command-line arguments or options',
+    },
+    {
+        code: EXIT_CODES.PERMISSION_DENIED,
+        name: 'PERMISSION_DENIED',
+        description: 'Insufficient permissions for operation',
+    },
+    {
+        code: EXIT_CODES.RESOURCE_NOT_FOUND,
+        name: 'RESOURCE_NOT_FOUND',
+        description: 'Requested resource not found (session, file, etc.)',
+    },
+    {
+        code: EXIT_CODES.RESOURCE_ALREADY_EXISTS,
+        name: 'RESOURCE_ALREADY_EXISTS',
+        description: 'Resource already exists (duplicate session, etc.)',
+    },
+    {
+        code: EXIT_CODES.RESOURCE_BUSY,
+        name: 'RESOURCE_BUSY',
+        description: 'Resource is locked or busy',
+    },
+    {
+        code: EXIT_CODES.DAEMON_ALREADY_RUNNING,
+        name: 'DAEMON_ALREADY_RUNNING',
+        description: 'Daemon is already running',
+    },
+    {
+        code: EXIT_CODES.STALE_CACHE,
+        name: 'STALE_CACHE',
+        description: 'Cache invalidated by navigation or DOM changes',
+    },
+    {
+        code: EXIT_CODES.CHROME_LAUNCH_FAILURE,
+        name: 'CHROME_LAUNCH_FAILURE',
+        description: 'Chrome browser failed to launch',
+    },
+    {
+        code: EXIT_CODES.CDP_CONNECTION_FAILURE,
+        name: 'CDP_CONNECTION_FAILURE',
+        description: 'Failed to connect to Chrome DevTools Protocol',
+    },
+    { code: EXIT_CODES.CDP_TIMEOUT, name: 'CDP_TIMEOUT', description: 'CDP operation timed out' },
+    {
+        code: EXIT_CODES.SESSION_FILE_ERROR,
+        name: 'SESSION_FILE_ERROR',
+        description: 'Session file read/write error',
+    },
+    {
+        code: EXIT_CODES.UNHANDLED_EXCEPTION,
+        name: 'UNHANDLED_EXCEPTION',
+        description: 'Unhandled exception in code',
+    },
+    {
+        code: EXIT_CODES.SIGNAL_HANDLER_ERROR,
+        name: 'SIGNAL_HANDLER_ERROR',
+        description: 'Signal handler error',
+    },
+    {
+        code: EXIT_CODES.SOFTWARE_ERROR,
+        name: 'SOFTWARE_ERROR',
+        description: 'Generic software error (use specific codes when possible)',
+    },
+];
 //# sourceMappingURL=exitCodes.js.map

package/dist/utils/exitCodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qCAAqC;IACrC,OAAO,EAAE,CAAC;IAEV,yDAAyD;IACzD,eAAe,EAAE,CAAC;IAElB,4CAA4C;IAC5C,WAAW,EAAE,EAAE;IAEf,gDAAgD;IAChD,iBAAiB,EAAE,EAAE;IAErB,6CAA6C;IAC7C,iBAAiB,EAAE,EAAE;IAErB,yDAAyD;IACzD,kBAAkB,EAAE,EAAE;IAEtB,wDAAwD;IACxD,uBAAuB,EAAE,EAAE;IAE3B,iCAAiC;IACjC,aAAa,EAAE,EAAE;IAEjB,kDAAkD;IAClD,sBAAsB,EAAE,EAAE;IAE1B,sCAAsC;IACtC,qBAAqB,EAAE,GAAG;IAE1B,4BAA4B;IAC5B,sBAAsB,EAAE,GAAG;IAE3B,8BAA8B;IAC9B,WAAW,EAAE,GAAG;IAEhB,oCAAoC;IACpC,kBAAkB,EAAE,GAAG;IAEvB,kCAAkC;IAClC,mBAAmB,EAAE,GAAG;IAExB,2BAA2B;IAC3B,oBAAoB,EAAE,GAAG;IAEzB,gEAAgE;IAChE,cAAc,EAAE,GAAG;CACX,CAAC"}
+{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"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"}

package/dist/utils/suggestions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Suggestion utilities for typo detection and helpful error messages.
+ */
+interface SimilarityOptions {
+    maxDistance?: number;
+    maxSuggestions?: number;
+    caseInsensitive?: boolean;
+}
+export declare function findSimilar(input: string, candidates: readonly string[], options?: SimilarityOptions): string[];
+export declare function formatSuggestions(suggestions: readonly string[], options?: {
+    prefix?: string;
+    suffix?: string;
+}): string;
+export declare function getSuggestion(input: string, candidates: readonly string[], options?: SimilarityOptions & {
+    prefix?: string;
+    suffix?: string;
+}): string;
+export {};
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/utils/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../src/utils/suggestions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,UAAU,iBAAiB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAgCD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,MAAM,CAIR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,GAAE,iBAAiB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,MAAM,CAER"}

package/dist/utils/suggestions.js

@@ -0,0 +1,34 @@
+/**
+ * Suggestion utilities for typo detection and helpful error messages.
+ */
+import { levenshteinDistance } from '../utils/levenshtein.js';
+function normalizeForComparison(str, caseInsensitive) {
+    return caseInsensitive ? str.toLowerCase() : str;
+}
+function findMatches(input, candidates, maxDistance, caseInsensitive) {
+    const normalizedInput = normalizeForComparison(input, caseInsensitive);
+    const matches = [];
+    for (const candidate of candidates) {
+        const normalizedCandidate = normalizeForComparison(candidate, caseInsensitive);
+        const distance = levenshteinDistance(normalizedInput, normalizedCandidate);
+        if (distance > 0 && distance <= maxDistance) {
+            matches.push({ value: candidate, distance });
+        }
+    }
+    return matches.sort((a, b) => a.distance - b.distance);
+}
+export function findSimilar(input, candidates, options = {}) {
+    const { maxDistance = 3, maxSuggestions = 3, caseInsensitive = true } = options;
+    const matches = findMatches(input, candidates, maxDistance, caseInsensitive);
+    return matches.slice(0, maxSuggestions).map((m) => m.value);
+}
+export function formatSuggestions(suggestions, options = {}) {
+    if (suggestions.length === 0)
+        return '';
+    const { prefix = 'Did you mean: ', suffix = '?' } = options;
+    return `${prefix}${suggestions.join(', ')}${suffix}`;
+}
+export function getSuggestion(input, candidates, options = {}) {
+    return formatSuggestions(findSimilar(input, candidates, options), options);
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/utils/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../../src/utils/suggestions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAa7D,SAAS,sBAAsB,CAAC,GAAW,EAAE,eAAwB;IACnE,OAAO,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,SAAS,WAAW,CAClB,KAAa,EACb,UAA6B,EAC7B,WAAmB,EACnB,eAAwB;IAExB,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACvE,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;QAE3E,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,UAA6B,EAC7B,UAA6B,EAAE;IAE/B,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,cAAc,GAAG,CAAC,EAAE,eAAe,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAChF,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,WAA8B,EAC9B,UAAgD,EAAE;IAElD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAC5D,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,UAA6B,EAC7B,UAAoE,EAAE;IAEtE,OAAO,iBAAiB,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC"}

package/dist/utils/taskMappings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskMappings.d.ts","sourceRoot":"","sources":["../../src/utils/taskMappings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAmHrD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAEhE"}
+{"version":3,"file":"taskMappings.d.ts","sourceRoot":"","sources":["../../src/utils/taskMappings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA6JrD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAEhE"}

package/dist/utils/taskMappings.js

@@ -105,6 +105,41 @@ export const TASK_MAPPINGS = {
         description: 'Check current session and daemon status',
         cdpAlternative: 'IPC ping + process checks',
     },
+    cleanup_session: {
+        commands: ['cleanup'],
+        description: 'Clean up stale session files and processes',
+        cdpAlternative: 'Manual process termination + file cleanup',
+    },
+    stop_session: {
+        commands: ['stop'],
+        description: 'Stop session and write collected telemetry',
+        cdpAlternative: 'Target.closeTarget + file write',
+    },
+    submit_form: {
+        commands: ['dom submit'],
+        description: 'Submit form by clicking submit button and waiting for completion',
+        cdpAlternative: 'Runtime.evaluate with form.submit() or button.click()',
+    },
+    navigate_to_url: {
+        commands: ['bdg <url>'],
+        description: 'Start session and navigate to URL',
+        cdpAlternative: 'Page.navigate',
+    },
+    filter_network_requests: {
+        commands: ['network list --filter', 'network list --preset'],
+        description: 'Filter network requests by type, status, or preset',
+        cdpAlternative: 'Network domain events with client-side filtering',
+    },
+    get_network_details: {
+        commands: ['details network <id>'],
+        description: 'Get full request/response details including body',
+        cdpAlternative: 'Network.getResponseBody',
+    },
+    get_document_headers: {
+        commands: ['network document'],
+        description: 'Show main HTML document request headers (shortcut for document request)',
+        cdpAlternative: 'Network.requestWillBeSent + Network.responseReceived for Document type',
+    },
 };
 /**
  * Get all task mappings.

package/dist/utils/taskMappings.js.map

@@ -1 +1 @@
-{"version":3,"file":"taskMappings.js","sourceRoot":"","sources":["../../src/utils/taskMappings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"taskMappings.js","sourceRoot":"","sources":["../../src/utils/taskMappings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,kBAAkB,EAAE;QAClB,QAAQ,EAAE,CAAC,gBAAgB,CAAC;QAC5B,WAAW,EAAE,sCAAsC;QACnD,cAAc,EAAE,wBAAwB;KACzC;IAED,kBAAkB,EAAE;QAClB,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,WAAW,EAAE,oCAAoC;QACjD,cAAc,EAAE,qCAAqC;KACtD;IAED,kBAAkB,EAAE;QAClB,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,WAAW,EAAE,8CAA8C;QAC3D,cAAc,EAAE,kBAAkB;KACnC;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,WAAW,EAAE,mCAAmC;QAChD,cAAc,EAAE,wCAAwC;KACzD;IAED,aAAa,EAAE;QACb,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,WAAW,EAAE,2BAA2B;QACxC,cAAc,EAAE,+BAA+B;KAChD;IAED,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,WAAW,EAAE,0DAA0D;QACvE,cAAc,EAAE,wBAAwB;KACzC;IAED,mBAAmB,EAAE;QACnB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,WAAW,EAAE,kCAAkC;QAC/C,cAAc,EAAE,2CAA2C;KAC5D;IAED,kBAAkB,EAAE;QAClB,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,WAAW,EAAE,4CAA4C;QACzD,cAAc,EAAE,6BAA6B;KAC9C;IAED,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,WAAW,EAAE,oCAAoC;QACjD,cAAc,EAAE,kCAAkC;KACnD;IAED,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,oBAAoB,CAAC;QAChC,WAAW,EAAE,kCAAkC;QAC/C,cAAc,EAAE,uBAAuB;KACxC;IAED,mBAAmB,EAAE;QACnB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;QAC7B,WAAW,EAAE,uCAAuC;QACpD,cAAc,EAAE,sCAAsC;KACvD;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,WAAW,EACT,yFAAyF;QAC3F,cAAc,EAAE,yDAAyD;KAC1E;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,mBAAmB,CAAC;QAC/B,WAAW,EAAE,2CAA2C;QACxD,cAAc,EAAE,iCAAiC;KAClD;IAED,cAAc,EAAE;QACd,QAAQ,EAAE,CAAC,kBAAkB,CAAC;QAC9B,WAAW,EAAE,sCAAsC;QACnD,cAAc,EAAE,6CAA6C;KAC9D;IAED,qBAAqB,EAAE;QACrB,QAAQ,EAAE,CAAC,gBAAgB,CAAC;QAC5B,WAAW,EAAE,2CAA2C;QACxD,cAAc,EAAE,iCAAiC;KAClD;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,4CAA4C;QACzD,cAAc,EAAE,sCAAsC;KACvD;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC;QACnC,WAAW,EAAE,sCAAsC;QACnD,cAAc,EAAE,6CAA6C;KAC9D;IAED,gBAAgB,EAAE;QAChB,QAAQ,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;QAChD,WAAW,EAAE,0DAA0D;QACvE,cAAc,EAAE,0CAA0C;KAC3D;IAED,oBAAoB,EAAE;QACpB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,WAAW,EAAE,yCAAyC;QACtD,cAAc,EAAE,2BAA2B;KAC5C;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,WAAW,EAAE,4CAA4C;QACzD,cAAc,EAAE,2CAA2C;KAC5D;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,4CAA4C;QACzD,cAAc,EAAE,iCAAiC;KAClD;IAED,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,WAAW,EAAE,kEAAkE;QAC/E,cAAc,EAAE,uDAAuD;KACxE;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,WAAW,EAAE,mCAAmC;QAChD,cAAc,EAAE,eAAe;KAChC;IAED,uBAAuB,EAAE;QACvB,QAAQ,EAAE,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;QAC5D,WAAW,EAAE,oDAAoD;QACjE,cAAc,EAAE,kDAAkD;KACnE;IAED,mBAAmB,EAAE;QACnB,QAAQ,EAAE,CAAC,sBAAsB,CAAC;QAClC,WAAW,EAAE,kDAAkD;QAC/D,cAAc,EAAE,yBAAyB;KAC1C;IAED,oBAAoB,EAAE;QACpB,QAAQ,EAAE,CAAC,kBAAkB,CAAC;QAC9B,WAAW,EAAE,yEAAyE;QACtF,cAAc,EAAE,wEAAwE;KACzF;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/utils/typeGuards.d.ts

@@ -47,16 +47,23 @@ export declare function isConsoleMessage(value: unknown): value is ConsoleMessag
  * Replaces unsafe `as unknown as` assertions with runtime validation.
  * Throws CommandError if validation fails.
  *
+ * Uses function overloads to return the correct type based on the `type` parameter,
+ * enabling proper type narrowing in discriminated unions.
+ *
  * @param item - Unknown item from IPC response
  * @param type - Expected type ('network' or 'console')
- * @returns Validated NetworkRequest or ConsoleMessage
+ * @returns Validated NetworkRequest or ConsoleMessage based on type parameter
  * @throws CommandError if item fails validation
  *
  * @example
  * ```typescript
- * const validatedItem = validateDetailsItem(response.data.item, 'network');
- * // validatedItem is now typed as NetworkRequest | ConsoleMessage
+ * const networkItem = validateDetailsItem(response.data.item, 'network');
+ * // networkItem is typed as NetworkRequest
+ *
+ * const consoleItem = validateDetailsItem(response.data.item, 'console');
+ * // consoleItem is typed as ConsoleMessage
  * ```
  */
-export declare function validateDetailsItem(item: unknown, type: 'network' | 'console'): NetworkRequest | ConsoleMessage;
+export declare function validateDetailsItem(item: unknown, type: 'network'): NetworkRequest;
+export declare function validateDetailsItem(item: unknown, type: 'console'): ConsoleMessage;
 //# sourceMappingURL=typeGuards.d.ts.map

package/dist/utils/typeGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAaxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAYxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,cAAc,GAAG,cAAc,CA4BjC"}
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAaxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAYxE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;AAEpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC"}

package/dist/utils/typeGuards.js

@@ -59,23 +59,7 @@ export function isConsoleMessage(value) {
         typeof record['text'] === 'string' &&
         typeof record['timestamp'] === 'number');
 }
-/**
- * Validate and return a details item with proper type safety.
- *
- * Replaces unsafe `as unknown as` assertions with runtime validation.
- * Throws CommandError if validation fails.
- *
- * @param item - Unknown item from IPC response
- * @param type - Expected type ('network' or 'console')
- * @returns Validated NetworkRequest or ConsoleMessage
- * @throws CommandError if item fails validation
- *
- * @example
- * ```typescript
- * const validatedItem = validateDetailsItem(response.data.item, 'network');
- * // validatedItem is now typed as NetworkRequest | ConsoleMessage
- * ```
- */
+// eslint-disable-next-line no-redeclare
 export function validateDetailsItem(item, type) {
     if (!item || typeof item !== 'object') {
         throw new CommandError('Invalid item data: expected an object', { suggestion: 'This may indicate corrupted data from the daemon' }, EXIT_CODES.SESSION_FILE_ERROR);

package/dist/utils/typeGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,OAAO,CACL,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ;QACvC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;QACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,CACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,OAAO,CACL,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,CACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAa,EACb,IAA2B;IAE3B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,YAAY,CACpB,uCAAuC,EACvC,EAAE,UAAU,EAAE,kDAAkD,EAAE,EAClE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CACpB,2FAA2F,EAC3F,EAAE,UAAU,EAAE,iDAAiD,EAAE,EACjE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CACpB,+EAA+E,EAC/E,EAAE,UAAU,EAAE,yDAAyD,EAAE,EACzE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../src/utils/typeGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,OAAO,CACL,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ;QACvC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;QACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,CACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,OAAO,CACL,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,CACxC,CAAC;AACJ,CAAC;AA4BD,wCAAwC;AACxC,MAAM,UAAU,mBAAmB,CACjC,IAAa,EACb,IAA2B;IAE3B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,YAAY,CACpB,uCAAuC,EACvC,EAAE,UAAU,EAAE,kDAAkD,EAAE,EAClE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CACpB,2FAA2F,EAC3F,EAAE,UAAU,EAAE,iDAAiD,EAAE,EACjE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CACpB,+EAA+E,EAC/E,EAAE,UAAU,EAAE,yDAAyD,EAAE,EACzE,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-debugger-cli",
-  "version": "0.6.9",
+  "version": "0.6.11",
   "description": "DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.",
   "type": "module",
   "bin": {
@@ -46,12 +46,12 @@
   "dependencies": {
     "chrome-launcher": "^1.2.1",
     "commander": "^14.0.2",
-    "devtools-protocol": "^0.0.1543509",
+    "devtools-protocol": "^0.0.1548823",
     "ws": "^8.18.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.0",
-    "@types/node": "^22.19.0",
+    "@types/node": "^24.10.1",
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^8.46.2",
     "@typescript-eslint/parser": "^8.46.2",
@@ -62,7 +62,7 @@
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-no-relative-import-paths": "^1.6.1",
-    "eslint-plugin-tsdoc": "^0.4.0",
+    "eslint-plugin-tsdoc": "^0.5.0",
     "eslint-plugin-unused-imports": "^4.3.0",
     "globals": "^16.5.0",
     "husky": "^9.1.7",