@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/utils/element-finder.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Element Finder - Shared element search and scoring utilities
+ *
+ * Used by click-element, interact, and find tools to locate elements
+ * by natural language query with consistent scoring logic.
+ */
+/**
+ * Represents a found element with its properties and match score.
+ */
+export interface FoundElement {
+    backendDOMNodeId: number;
+    role: string;
+    name: string;
+    tagName: string;
+    type?: string;
+    placeholder?: string;
+    ariaLabel?: string;
+    textContent?: string;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    score: number;
+}
+/**
+ * Tokenize a query string into meaningful search tokens.
+ * Filters out stop words and single-character tokens.
+ */
+export declare function tokenizeQuery(query: string): string[];
+/**
+ * Score an element based on how well it matches the query.
+ *
+ * Scoring priorities:
+ * - Exact name/text match: +100
+ * - Exact aria-label match: +90
+ * - Contains full query: +50/+45
+ * - Token matches: +15 per token
+ * - Role match bonus: +30
+ * - Interactive element bonus: +20
+ * - Size bonuses/penalties: +10/-20
+ */
+export declare function scoreElement(element: FoundElement, queryLower: string, queryTokens: string[]): number;
+/**
+ * CSS selectors for interactive elements, used by in-page search.
+ */
+export declare const INTERACTIVE_SELECTORS: string[];
+//# sourceMappingURL=element-finder.d.ts.map

package/dist/utils/element-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-finder.d.ts","sourceRoot":"","sources":["../../src/utils/element-finder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAuER;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAyBjC,CAAC"}

package/dist/utils/element-finder.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Element Finder - Shared element search and scoring utilities
+ *
+ * Used by click-element, interact, and find tools to locate elements
+ * by natural language query with consistent scoring logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTERACTIVE_SELECTORS = void 0;
+exports.tokenizeQuery = tokenizeQuery;
+exports.scoreElement = scoreElement;
+/**
+ * Stop words filtered out when tokenizing queries.
+ */
+const STOP_WORDS = new Set([
+    'the', 'a', 'an', 'to', 'for', 'of', 'in', 'on', 'at', 'and', 'or',
+]);
+/**
+ * Tokenize a query string into meaningful search tokens.
+ * Filters out stop words and single-character tokens.
+ */
+function tokenizeQuery(query) {
+    return query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(t => t.length > 1)
+        .filter(t => !STOP_WORDS.has(t));
+}
+/**
+ * Score an element based on how well it matches the query.
+ *
+ * Scoring priorities:
+ * - Exact name/text match: +100
+ * - Exact aria-label match: +90
+ * - Contains full query: +50/+45
+ * - Token matches: +15 per token
+ * - Role match bonus: +30
+ * - Interactive element bonus: +20
+ * - Size bonuses/penalties: +10/-20
+ */
+function scoreElement(element, queryLower, queryTokens) {
+    let score = 0;
+    const nameLower = element.name.toLowerCase();
+    const textLower = element.textContent?.toLowerCase() || '';
+    const ariaLower = element.ariaLabel?.toLowerCase() || '';
+    const placeholderLower = element.placeholder?.toLowerCase() || '';
+    // Exact match bonus (highest priority)
+    if (nameLower === queryLower || textLower === queryLower) {
+        score += 100;
+    }
+    // Aria label exact match
+    if (ariaLower === queryLower) {
+        score += 90;
+    }
+    // Contains full query
+    if (nameLower.includes(queryLower) || textLower.includes(queryLower)) {
+        score += 50;
+    }
+    if (ariaLower.includes(queryLower)) {
+        score += 45;
+    }
+    // Token matching (partial match for multi-word queries)
+    const combinedText = `${nameLower} ${textLower} ${ariaLower} ${placeholderLower}`;
+    const matchedTokens = queryTokens.filter(token => combinedText.includes(token));
+    score += matchedTokens.length * 15;
+    // Role matching bonus - if query mentions role
+    const roleMatches = [
+        ['button', () => element.role === 'button' || element.tagName === 'button'],
+        ['link', () => element.role === 'link' || element.tagName === 'a'],
+        ['radio', () => element.role === 'radio' || element.type === 'radio'],
+        ['checkbox', () => element.role === 'checkbox' || element.type === 'checkbox'],
+        ['input', () => element.tagName === 'input' || element.tagName === 'textarea'],
+        ['switch', () => element.role === 'switch'],
+        ['toggle', () => element.role === 'switch'],
+        ['dropdown', () => element.role === 'combobox' || element.role === 'listbox'],
+        ['select', () => element.role === 'combobox' || element.role === 'listbox'],
+        ['slider', () => element.role === 'slider'],
+    ];
+    for (const [keyword, matcher] of roleMatches) {
+        if (queryLower.includes(keyword) && matcher()) {
+            score += 30;
+        }
+    }
+    // Interactive element bonus
+    if ([
+        'button', 'link', 'checkbox', 'radio', 'menuitem', 'tab',
+        'option', 'switch', 'combobox', 'listbox', 'slider', 'treeitem',
+    ].includes(element.role)) {
+        score += 20;
+    }
+    // Visible size bonus (larger elements are usually more important)
+    if (element.rect.width > 50 && element.rect.height > 20) {
+        score += 10;
+    }
+    // Penalty for very small elements (likely icons or hidden)
+    if (element.rect.width < 10 || element.rect.height < 10) {
+        score -= 20;
+    }
+    return score;
+}
+/**
+ * CSS selectors for interactive elements, used by in-page search.
+ */
+exports.INTERACTIVE_SELECTORS = [
+    'button',
+    '[role="button"]',
+    'a',
+    '[role="link"]',
+    'input[type="submit"]',
+    'input[type="button"]',
+    'input[type="radio"]',
+    'input[type="checkbox"]',
+    '[role="radio"]',
+    '[role="checkbox"]',
+    '[role="menuitem"]',
+    '[role="tab"]',
+    '[role="option"]',
+    '[onclick]',
+    '[tabindex]',
+    '[contenteditable="true"]',
+    '[role="combobox"]',
+    '[role="listbox"]',
+    '[role="switch"]',
+    '[role="slider"]',
+    '[role="treeitem"]',
+    '[role="dialog"] [aria-label]',
+    '[role="alertdialog"] [aria-label]',
+    '[data-testid]',
+];
+//# sourceMappingURL=element-finder.js.map

package/dist/utils/element-finder.js.map

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

package/dist/utils/format-age.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Format a timestamp age as a human-readable string (e.g., "30s ago", "2m ago", "1h ago").
+ */
+export declare function formatAge(timestamp: number): string;
+//# sourceMappingURL=format-age.d.ts.map

package/dist/utils/format-age.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-age.d.ts","sourceRoot":"","sources":["../../src/utils/format-age.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKnD"}

package/dist/utils/format-age.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAge = formatAge;
+/**
+ * Format a timestamp age as a human-readable string (e.g., "30s ago", "2m ago", "1h ago").
+ */
+function formatAge(timestamp) {
+    const ageMs = Date.now() - timestamp;
+    if (ageMs < 60000)
+        return `${Math.round(ageMs / 1000)}s ago`;
+    if (ageMs < 3600000)
+        return `${Math.round(ageMs / 60000)}m ago`;
+    return `${Math.round(ageMs / 3600000)}h ago`;
+}
+//# sourceMappingURL=format-age.js.map

package/dist/utils/format-age.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-age.js","sourceRoot":"","sources":["../../src/utils/format-age.ts"],"names":[],"mappings":";;AAGA,8BAKC;AARD;;GAEG;AACH,SAAgB,SAAS,CAAC,SAAiB;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACrC,IAAI,KAAK,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7D,IAAI,KAAK,GAAG,OAAO;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;IAChE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;AAC/C,CAAC"}

package/dist/utils/format-error.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Safely extract an error message from an unknown thrown value.
+ */
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=format-error.d.ts.map

package/dist/utils/format-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.d.ts","sourceRoot":"","sources":["../../src/utils/format-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD"}

package/dist/utils/format-error.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatError = formatError;
+/**
+ * Safely extract an error message from an unknown thrown value.
+ */
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=format-error.js.map

package/dist/utils/format-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.js","sourceRoot":"","sources":["../../src/utils/format-error.ts"],"names":[],"mappings":";;AAGA,kCAEC;AALD;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility exports
+ */
+export * from './atomic-file';
+export * from './json-validator';
+export * from './pid-manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Utility exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./atomic-file"), exports);
+__exportStar(require("./json-validator"), exports);
+__exportStar(require("./pid-manager"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,mDAAiC;AACjC,gDAA8B"}

package/dist/utils/json-validator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * JSON validation and corruption detection utilities
+ * Detects and attempts to recover from common JSON corruption patterns
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    corrupted?: boolean;
+    corruptionType?: 'concatenated' | 'truncated' | 'invalid' | 'empty';
+}
+export interface RecoveryResult {
+    success: boolean;
+    data?: unknown;
+    method?: string;
+    error?: string;
+}
+/**
+ * Check if a string is valid JSON
+ */
+export declare function isValidJson(content: string): boolean;
+/**
+ * Detect corruption in JSON content
+ * Identifies common corruption patterns from race conditions
+ */
+export declare function detectCorruption(content: string): ValidationResult;
+/**
+ * Extract valid JSON from corrupted content
+ * Attempts various recovery strategies
+ */
+export declare function extractValidJson(content: string): RecoveryResult;
+/**
+ * Merge two JSON objects, preferring values from the second
+ * Useful for recovering from partial writes
+ */
+export declare function mergeJsonObjects(obj1: Record<string, unknown>, obj2: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Validate .claude.json specific structure
+ */
+export declare function validateClaudeConfig(content: unknown): ValidationResult;
+//# sourceMappingURL=json-validator.d.ts.map

package/dist/utils/json-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-validator.d.ts","sourceRoot":"","sources":["../../src/utils/json-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;CACrE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA0DlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA4DhE;AA8HD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CA2BvE"}

package/dist/utils/json-validator.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * JSON validation and corruption detection utilities
+ * Detects and attempts to recover from common JSON corruption patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidJson = isValidJson;
+exports.detectCorruption = detectCorruption;
+exports.extractValidJson = extractValidJson;
+exports.mergeJsonObjects = mergeJsonObjects;
+exports.validateClaudeConfig = validateClaudeConfig;
+/**
+ * Check if a string is valid JSON
+ */
+function isValidJson(content) {
+    try {
+        JSON.parse(content);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect corruption in JSON content
+ * Identifies common corruption patterns from race conditions
+ */
+function detectCorruption(content) {
+    if (!content || content.trim() === '') {
+        return {
+            valid: false,
+            corrupted: true,
+            corruptionType: 'empty',
+            error: 'Empty content',
+        };
+    }
+    // Check for concatenated JSON objects (common race condition pattern)
+    // Pattern: }{  indicates two JSON objects were written together
+    if (content.includes('}{')) {
+        return {
+            valid: false,
+            corrupted: true,
+            corruptionType: 'concatenated',
+            error: 'Detected concatenated JSON objects (race condition corruption)',
+        };
+    }
+    // Check for multiple JSON arrays concatenated
+    if (content.includes('][')) {
+        return {
+            valid: false,
+            corrupted: true,
+            corruptionType: 'concatenated',
+            error: 'Detected concatenated JSON arrays',
+        };
+    }
+    // Try to parse
+    try {
+        JSON.parse(content);
+        return { valid: true };
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        // Detect truncated JSON
+        if (errorMessage.includes('Unexpected end of JSON') ||
+            errorMessage.includes('Unexpected end of input')) {
+            return {
+                valid: false,
+                corrupted: true,
+                corruptionType: 'truncated',
+                error: 'JSON appears to be truncated',
+            };
+        }
+        return {
+            valid: false,
+            corrupted: true,
+            corruptionType: 'invalid',
+            error: `Invalid JSON: ${errorMessage}`,
+        };
+    }
+}
+/**
+ * Extract valid JSON from corrupted content
+ * Attempts various recovery strategies
+ */
+function extractValidJson(content) {
+    // Strategy 1: Content is already valid
+    if (isValidJson(content)) {
+        return {
+            success: true,
+            data: JSON.parse(content),
+            method: 'content_already_valid',
+        };
+    }
+    const trimmed = content.trim();
+    // Strategy 2: Handle concatenated JSON objects
+    // Take the first complete JSON object
+    if (trimmed.includes('}{')) {
+        const firstObjectEnd = findMatchingBrace(trimmed, 0);
+        if (firstObjectEnd !== -1) {
+            const firstObject = trimmed.substring(0, firstObjectEnd + 1);
+            if (isValidJson(firstObject)) {
+                return {
+                    success: true,
+                    data: JSON.parse(firstObject),
+                    method: 'extract_first_object',
+                };
+            }
+        }
+        // Alternative: try to take the second object (might be more recent)
+        const secondStart = trimmed.indexOf('}{') + 1;
+        const secondObject = trimmed.substring(secondStart);
+        if (isValidJson(secondObject)) {
+            return {
+                success: true,
+                data: JSON.parse(secondObject),
+                method: 'extract_second_object',
+            };
+        }
+    }
+    // Strategy 3: Handle truncated JSON
+    // Try to complete the JSON by adding missing brackets
+    const result = attemptTruncatedRecovery(trimmed);
+    if (result.success) {
+        return result;
+    }
+    // Strategy 4: Look for the largest valid JSON substring
+    const largestValid = findLargestValidJson(trimmed);
+    if (largestValid) {
+        return {
+            success: true,
+            data: JSON.parse(largestValid),
+            method: 'largest_valid_substring',
+        };
+    }
+    return {
+        success: false,
+        error: 'Could not recover valid JSON from content',
+    };
+}
+/**
+ * Find the index of the matching closing brace for an opening brace
+ */
+function findMatchingBrace(content, startIndex) {
+    let depth = 0;
+    let inString = false;
+    let escapeNext = false;
+    for (let i = startIndex; i < content.length; i++) {
+        const char = content[i];
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        if (char === '\\' && inString) {
+            escapeNext = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === '{') {
+            depth++;
+        }
+        else if (char === '}') {
+            depth--;
+            if (depth === 0) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+/**
+ * Attempt to recover truncated JSON
+ */
+function attemptTruncatedRecovery(content) {
+    // Count open brackets and braces
+    let openBraces = 0;
+    let openBrackets = 0;
+    let inString = false;
+    let escapeNext = false;
+    for (const char of content) {
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        if (char === '\\' && inString) {
+            escapeNext = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        switch (char) {
+            case '{':
+                openBraces++;
+                break;
+            case '}':
+                openBraces--;
+                break;
+            case '[':
+                openBrackets++;
+                break;
+            case ']':
+                openBrackets--;
+                break;
+        }
+    }
+    // If we're inside a string, try to close it
+    if (inString) {
+        content += '"';
+    }
+    // Try to complete with missing brackets/braces
+    const closing = ']'.repeat(Math.max(0, openBrackets)) +
+        '}'.repeat(Math.max(0, openBraces));
+    if (closing) {
+        const completed = content + closing;
+        if (isValidJson(completed)) {
+            return {
+                success: true,
+                data: JSON.parse(completed),
+                method: 'complete_truncated',
+            };
+        }
+    }
+    return { success: false, error: 'Truncated recovery failed' };
+}
+/**
+ * Find the largest valid JSON substring
+ */
+function findLargestValidJson(content) {
+    // Start from the beginning, try to find complete JSON objects
+    for (let end = content.length; end > 1; end--) {
+        const substring = content.substring(0, end);
+        if (isValidJson(substring)) {
+            return substring;
+        }
+    }
+    return null;
+}
+/**
+ * Merge two JSON objects, preferring values from the second
+ * Useful for recovering from partial writes
+ */
+function mergeJsonObjects(obj1, obj2) {
+    const result = { ...obj1 };
+    for (const [key, value] of Object.entries(obj2)) {
+        if (value !== null &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            result[key] &&
+            typeof result[key] === 'object' &&
+            !Array.isArray(result[key])) {
+            // Recursively merge objects
+            result[key] = mergeJsonObjects(result[key], value);
+        }
+        else if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Validate .claude.json specific structure
+ */
+function validateClaudeConfig(content) {
+    if (typeof content !== 'object' || content === null) {
+        return {
+            valid: false,
+            error: 'Config must be an object',
+        };
+    }
+    const config = content;
+    // Check for expected top-level keys (optional validation)
+    const expectedKeys = [
+        'numStartups',
+        'tipsHistory',
+        'userID',
+        'firstStartTime',
+    ];
+    const hasExpectedKeys = expectedKeys.some((key) => key in config);
+    if (!hasExpectedKeys && Object.keys(config).length > 0) {
+        return {
+            valid: false,
+            error: 'Config missing expected Claude configuration keys',
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=json-validator.js.map

package/dist/utils/json-validator.js.map

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

package/dist/utils/page-diagnostics.d.ts

@@ -0,0 +1,23 @@
+import type { Page } from 'puppeteer-core';
+export interface PageDiagnostics {
+    url: string;
+    readyState: string;
+    totalElements: number;
+    framework: string | null;
+    title: string;
+}
+export interface BlockingInfo {
+    type: 'captcha' | 'bot-check' | 'access-denied' | 'js-required';
+    detail: string;
+}
+/**
+ * Get basic page diagnostics for failure reporting.
+ * Lightweight - single evaluate call.
+ */
+export declare function getPageDiagnostics(page: Page): Promise<PageDiagnostics>;
+/**
+ * Detect if the page is showing a blocking verification/captcha/access-denied page.
+ * Returns null if page appears normal.
+ */
+export declare function detectBlockingPage(page: Page): Promise<BlockingInfo | null>;
+//# sourceMappingURL=page-diagnostics.d.ts.map