claude-chrome-parallel 1.0.0

package/dist/types/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/types/profile.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA+DH;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAExB;IACA;IAFlB,YACkB,SAAiB,EACjB,WAAmB;QAEnC,KAAK,CAAC,YAAY,SAAS,sEAAsE,CAAC,CAAC;QAHnF,cAAS,GAAT,SAAS,CAAQ;QACjB,gBAAW,GAAX,WAAW,CAAQ;QAGnC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AARD,8CAQC;AAED;;GAEG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAE3B;IACA;IAFlB,YACkB,SAAiB,EACjB,iBAA2B;QAE3C,KAAK,CACH,YAAY,SAAS,oCAAoC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAClG,CAAC;QALc,cAAS,GAAT,SAAS,CAAQ;QACjB,sBAAiB,GAAjB,iBAAiB,CAAU;QAK3C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAVD,oDAUC"}

package/dist/types/session.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Session Types
+ */
+import { BrowserContext } from 'puppeteer-core';
+/**
+ * Worker - An isolated browser context within a session
+ * Each worker has its own cookies, localStorage, sessionStorage
+ * Enables parallel browser operations from a single Claude Code session
+ */
+export interface Worker {
+    id: string;
+    name: string;
+    targets: Set<string>;
+    context: BrowserContext | null;
+    createdAt: number;
+    lastActivityAt: number;
+    port?: number;
+    poolOrigin?: string;
+}
+export interface WorkerInfo {
+    id: string;
+    name: string;
+    targetCount: number;
+    createdAt: number;
+    lastActivityAt: number;
+}
+export interface WorkerCreateOptions {
+    id?: string;
+    name?: string;
+    shareCookies?: boolean;
+    targetUrl?: string;
+}
+export interface Session {
+    id: string;
+    /** Workers within this session (each with isolated browser context) */
+    workers: Map<string, Worker>;
+    /** Default worker for backwards compatibility */
+    defaultWorkerId: string;
+    createdAt: number;
+    lastActivityAt: number;
+    name: string;
+    targets: Set<string>;
+    context?: BrowserContext | null;
+}
+export interface SessionInfo {
+    id: string;
+    targetCount: number;
+    workerCount: number;
+    workers: WorkerInfo[];
+    createdAt: number;
+    lastActivityAt: number;
+    name: string;
+}
+export interface SessionCreateOptions {
+    id?: string;
+    name?: string;
+}
+export interface SessionEvent {
+    type: 'session:created' | 'session:deleted' | 'session:target-added' | 'session:target-removed' | 'session:target-closed' | 'worker:created' | 'worker:deleted';
+    sessionId: string;
+    targetId?: string;
+    workerId?: string;
+    timestamp: number;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,wBAAwB,GAAG,uBAAuB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;IAChK,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/session.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Session Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/tool-manifest.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tool Manifest Types - Shared Tool Registry for worker agents
+ *
+ * Enables workflow_init to export registered tool schemas so that
+ * worker agents can skip ToolSearch and call tools immediately.
+ */
+/** A single tool entry in the manifest */
+export interface ToolEntry {
+    /** Full MCP tool name (e.g. "navigate", "javascript_tool") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for tool parameters */
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    /** Tool category for filtering */
+    category: ToolCategory;
+}
+/** Tool categories for WorkerToolConfig filtering */
+export type ToolCategory = 'navigation' | 'interaction' | 'content' | 'javascript' | 'network' | 'tabs' | 'media' | 'emulation' | 'orchestration' | 'worker' | 'composite' | 'performance' | 'lifecycle';
+/** The complete tool manifest exported by the MCP server */
+export interface ToolManifest {
+    /** Manifest version for cache invalidation */
+    version: string;
+    /** Generation timestamp */
+    generatedAt: number;
+    /** All registered tools */
+    tools: ToolEntry[];
+    /** Total tool count */
+    toolCount: number;
+}
+/** Per-worker tool access configuration */
+export interface WorkerToolConfig {
+    /** Worker type determines default tool set */
+    workerType: 'extraction' | 'interaction' | 'full';
+    /** Allowed tool categories (whitelist) */
+    allowedCategories?: ToolCategory[];
+    /** Specific tools to include regardless of category */
+    additionalTools?: string[];
+    /** Specific tools to exclude regardless of category */
+    excludedTools?: string[];
+}
+/** Default tool sets per worker type */
+export declare const DEFAULT_WORKER_TOOLS: Record<WorkerToolConfig['workerType'], ToolCategory[]>;
+/**
+ * Filter manifest tools based on WorkerToolConfig
+ */
+export declare function filterToolsForWorker(manifest: ToolManifest, config: WorkerToolConfig): ToolEntry[];
+//# sourceMappingURL=tool-manifest.d.ts.map

package/dist/types/tool-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-manifest.d.ts","sourceRoot":"","sources":["../../src/types/tool-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,aAAa,GACb,SAAS,GACT,YAAY,GACZ,SAAS,GACT,MAAM,GACN,OAAO,GACP,WAAW,GACX,eAAe,GACf,QAAQ,GACR,WAAW,GACX,aAAa,GACb,WAAW,CAAC;AAEhB,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,UAAU,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;IAClD,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,YAAY,EAAE,CAAC;IACnC,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wCAAwC;AACxC,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,CAOvF,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,gBAAgB,GACvB,SAAS,EAAE,CAmBb"}

package/dist/types/tool-manifest.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Tool Manifest Types - Shared Tool Registry for worker agents
+ *
+ * Enables workflow_init to export registered tool schemas so that
+ * worker agents can skip ToolSearch and call tools immediately.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_WORKER_TOOLS = void 0;
+exports.filterToolsForWorker = filterToolsForWorker;
+/** Default tool sets per worker type */
+exports.DEFAULT_WORKER_TOOLS = {
+    extraction: ['javascript', 'content', 'composite'],
+    interaction: ['navigation', 'interaction', 'content', 'javascript', 'composite'],
+    full: [
+        'navigation', 'interaction', 'content', 'javascript',
+        'network', 'tabs', 'media', 'emulation', 'composite', 'performance',
+    ],
+};
+/**
+ * Filter manifest tools based on WorkerToolConfig
+ */
+function filterToolsForWorker(manifest, config) {
+    const allowedCategories = config.allowedCategories || exports.DEFAULT_WORKER_TOOLS[config.workerType];
+    let tools = manifest.tools.filter(t => allowedCategories.includes(t.category));
+    // Add specific additional tools
+    if (config.additionalTools?.length) {
+        const additional = manifest.tools.filter(t => config.additionalTools.includes(t.name) && !tools.some(existing => existing.name === t.name));
+        tools = [...tools, ...additional];
+    }
+    // Remove excluded tools
+    if (config.excludedTools?.length) {
+        tools = tools.filter(t => !config.excludedTools.includes(t.name));
+    }
+    return tools;
+}
+//# sourceMappingURL=tool-manifest.js.map

package/dist/types/tool-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-manifest.js","sourceRoot":"","sources":["../../src/types/tool-manifest.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuEH,oDAsBC;AAnCD,wCAAwC;AAC3B,QAAA,oBAAoB,GAA2D;IAC1F,UAAU,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC;IAClD,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC;IAChF,IAAI,EAAE;QACJ,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY;QACpD,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa;KACpE;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,oBAAoB,CAClC,QAAsB,EACtB,MAAwB;IAExB,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,4BAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE9F,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/E,gCAAgC;IAChC,IAAI,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,eAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CACnG,CAAC;QACF,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QACjC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,aAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/atomic-file.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Atomic file operations for safe concurrent access
+ * Prevents race conditions when multiple processes access the same file
+ */
+export interface WriteOptions {
+    /** Create backup before writing */
+    backup?: boolean;
+    /** Timeout for acquiring lock (ms) */
+    lockTimeout?: number;
+}
+export interface ReadResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    corrupted?: boolean;
+}
+/**
+ * Write file atomically using temp file + rename pattern
+ * This ensures the file is never in a partial/corrupt state
+ */
+export declare function writeFileAtomicSafe(filePath: string, data: string | object, options?: WriteOptions): Promise<void>;
+/**
+ * Read file safely with JSON validation
+ */
+export declare function readFileSafe<T = unknown>(filePath: string): Promise<ReadResult<T>>;
+/**
+ * Create a backup of a file
+ */
+export declare function backupFile(filePath: string, backupDir?: string): Promise<string>;
+/**
+ * Restore a file from backup
+ */
+export declare function restoreFromBackup(backupPath: string, targetPath: string): Promise<void>;
+/**
+ * Get list of available backups for a file
+ */
+export declare function listBackups(originalFilename: string, backupDir?: string): string[];
+/**
+ * Clean up old backups, keeping only the specified number
+ */
+export declare function cleanupBackups(originalFilename: string, keepCount?: number, backupDir?: string): number;
+/**
+ * Acquire a file lock with timeout
+ */
+export declare function acquireLock(filePath: string, timeout?: number): Promise<() => Promise<void>>;
+/**
+ * Check if a file is currently locked
+ */
+export declare function isLocked(filePath: string): Promise<boolean>;
+//# sourceMappingURL=atomic-file.d.ts.map

package/dist/utils/atomic-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-file.d.ts","sourceRoot":"","sources":["../../src/utils/atomic-file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAgCxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAoBV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,SAAS,GAAE,MAAU,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAoB9B;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKjE"}

package/dist/utils/atomic-file.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Atomic file operations for safe concurrent access
+ * Prevents race conditions when multiple processes access the same file
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFileAtomicSafe = writeFileAtomicSafe;
+exports.readFileSafe = readFileSafe;
+exports.backupFile = backupFile;
+exports.restoreFromBackup = restoreFromBackup;
+exports.listBackups = listBackups;
+exports.cleanupBackups = cleanupBackups;
+exports.acquireLock = acquireLock;
+exports.isLocked = isLocked;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const write_file_atomic_1 = __importDefault(require("write-file-atomic"));
+const lockfile = __importStar(require("proper-lockfile"));
+/**
+ * Write file atomically using temp file + rename pattern
+ * This ensures the file is never in a partial/corrupt state
+ */
+async function writeFileAtomicSafe(filePath, data, options = {}) {
+    const { backup = false, lockTimeout = 10000 } = options;
+    const content = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    // Ensure directory exists
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Create backup if requested and file exists
+    if (backup && fs.existsSync(filePath)) {
+        await backupFile(filePath);
+    }
+    // Use write-file-atomic for safe writing
+    await (0, write_file_atomic_1.default)(filePath, content, { encoding: 'utf8' });
+}
+/**
+ * Read file safely with JSON validation
+ */
+async function readFileSafe(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return { success: false, error: 'File does not exist' };
+        }
+        const content = fs.readFileSync(filePath, 'utf8');
+        // Try to parse as JSON
+        try {
+            const data = JSON.parse(content);
+            return { success: true, data };
+        }
+        catch (parseError) {
+            // Check if it's a corruption pattern (two JSON objects concatenated)
+            if (content.includes('}{')) {
+                return {
+                    success: false,
+                    error: 'JSON parse error - corruption detected',
+                    corrupted: true,
+                };
+            }
+            return {
+                success: false,
+                error: `JSON parse error: ${parseError.message}`,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Read error: ${error.message}`,
+        };
+    }
+}
+/**
+ * Create a backup of a file
+ */
+async function backupFile(filePath, backupDir) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`File does not exist: ${filePath}`);
+    }
+    // Default backup directory
+    const defaultBackupDir = path.join(os.homedir(), '.claude-chrome-parallel', 'backups');
+    const targetDir = backupDir || defaultBackupDir;
+    // Ensure backup directory exists
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    // Generate backup filename with timestamp
+    const basename = path.basename(filePath);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupName = `${basename}.${timestamp}.bak`;
+    const backupPath = path.join(targetDir, backupName);
+    // Copy file to backup location
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+/**
+ * Restore a file from backup
+ */
+async function restoreFromBackup(backupPath, targetPath) {
+    if (!fs.existsSync(backupPath)) {
+        throw new Error(`Backup file does not exist: ${backupPath}`);
+    }
+    // Ensure target directory exists
+    const targetDir = path.dirname(targetPath);
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    // Use atomic write to restore
+    const content = fs.readFileSync(backupPath, 'utf8');
+    await writeFileAtomicSafe(targetPath, content);
+}
+/**
+ * Get list of available backups for a file
+ */
+function listBackups(originalFilename, backupDir) {
+    const defaultBackupDir = path.join(os.homedir(), '.claude-chrome-parallel', 'backups');
+    const targetDir = backupDir || defaultBackupDir;
+    if (!fs.existsSync(targetDir)) {
+        return [];
+    }
+    const basename = path.basename(originalFilename);
+    const pattern = new RegExp(`^${basename.replace('.', '\\.')}\\..*\\.bak$`);
+    return fs
+        .readdirSync(targetDir)
+        .filter((file) => pattern.test(file))
+        .sort()
+        .reverse(); // Most recent first
+}
+/**
+ * Clean up old backups, keeping only the specified number
+ */
+function cleanupBackups(originalFilename, keepCount = 5, backupDir) {
+    const backups = listBackups(originalFilename, backupDir);
+    const toDelete = backups.slice(keepCount);
+    const defaultBackupDir = path.join(os.homedir(), '.claude-chrome-parallel', 'backups');
+    const targetDir = backupDir || defaultBackupDir;
+    for (const backup of toDelete) {
+        const backupPath = path.join(targetDir, backup);
+        try {
+            fs.unlinkSync(backupPath);
+        }
+        catch {
+            // Ignore deletion errors
+        }
+    }
+    return toDelete.length;
+}
+/**
+ * Acquire a file lock with timeout
+ */
+async function acquireLock(filePath, timeout = 10000) {
+    // Ensure file exists for locking
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, '{}');
+    }
+    const release = await lockfile.lock(filePath, {
+        retries: {
+            retries: Math.ceil(timeout / 100),
+            factor: 1,
+            minTimeout: 100,
+            maxTimeout: 100,
+        },
+    });
+    return release;
+}
+/**
+ * Check if a file is currently locked
+ */
+async function isLocked(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return false;
+    }
+    return lockfile.check(filePath);
+}
+//# sourceMappingURL=atomic-file.js.map

package/dist/utils/atomic-file.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility exports
+ */
+export * from './atomic-file';
+export * from './json-validator';
+//# 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"}

package/dist/utils/index.js

@@ -0,0 +1,22 @@
+"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);
+//# 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"}

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"}